🚀 mcp-server-proxy 代理服务器

本代理服务器可将 MCP 协议的 SSE 传输层转换为标准 HTTP 请求/响应，极大简化了 MCP Server 的开发与使用。

🚀 快速开始

本工具旨在简化 MCP Server 的开发和使用，通过将 MCP 协议的 SSE 传输层转换为标准 HTTP 请求/响应，让开发者无需关注 SSE 协议细节，使用任意编程语言实现相关功能。

✨ 主要特性

• 支持将 MCP 协议的 SSE 传输层转换为标准 HTTP 请求/响应。
• 提供请求和响应的检查功能，助力研究 MCP Client 和 Server 的交互过程。
• 目前已支持 initialize、tools/list、tools/call 三个方法。

📦 安装指南

使用以下命令进行安装：

go install github.com/leizongmin/mcp-server-proxy@latest

💻 使用示例

基础用法

该工具提供两个主要命令：

1. inspect 命令

用于检查请求和响应的内容，主要用于研究 MCP Client 和 Server 的交互过程：

mcp-server-proxy inspect <local_url> <target_url>

例如：

mcp-server-proxy inspect http://localhost:8080 http://example.com

2. serve 命令

启动代理服务器，将 MCP Client 的调用转换为标准 HTTP 请求/响应：

mcp-server-proxy serve <local_url> <target_url>

例如：

mcp-server-proxy serve http://localhost:8080 http://example.com

高级用法

项目包含一个 JavaScript 示例（位于 example/js-echo 目录），实现了简单的 echo 功能，无需依赖 MCP 相关的 SDK，仅需处理几个简单的 HTTP 请求：

1. 进入示例目录：

cd example/js-echo

本示例使用 Hono 框架实现，核心代码如下：

import { Hono } from "hono";
import { logger } from "hono/logger";

const app = new Hono();

// 定义一个中间件来处理请求和响应
app.use((req, res) => {
    // 在这里可以添加自定义的逻辑
});

// 定义路由来处理具体的请求
app.get('/hello', (req, res) => {
    res.status(200).json({ message: 'Hello from Hono!' });
});

app.listen(3001);

2. 启动服务器：

node index.js

3. 启动代理服务器：

# 代理服务器监听 http://localhost:3002
# 代理服务器将请求转发到 http://localhost:3001
mcp-server-proxy serve http://localhost:3002 http://localhost:3001

4. 配置 MCP Client：

• Type: sse
• Server URL: http://localhost:3002/sse

5. 调用工具： 以 Cursor 为例，提交内容echo message "hello"后，它会识别出来需要调用 echo 工具，此时会出现【Call Tool】按钮，点击此按钮确认后即可看到工具调用结果。

📄 许可证

本项目采用 MIT 许可证。

💪 贡献

欢迎提交问题和 Pull Request！