JinDaGe - mcp-server-proxy-op5 MCP Details

article

README

🚀 mcp-server-proxy 代理服务器

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

🚀 快速开始

安装

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

✨ 主要特性

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

📦 安装指南

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

💻 使用示例

基础用法

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

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);

启动服务器：

node index.js

启动代理服务器：

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

配置 MCP Client：

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

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

cursor-call-echo-tool

📚 详细文档

为什么需要这个工具

MCP（Model Context Protocol）是一个开放协议，为 AI 应用提供了标准化的数据源和工具集成方案。目前 MCP 支持两种主要的传输协议：

Stdio 传输协议：
- 😫 需要在用户本地安装命令行工具，对运行环境有特定要求。
- 😫 用户需要进行相应的环境配置。
SSE（Server-Sent Events）传输协议：
- 👍 基于 HTTP 长连接实现，用户配置相对简单，主要是设置服务地址。
- 😫 相关开发工具和示例相对较少。

本工具通过以下方式简化 MCP Server 的开发和使用：

采用 SSE 传输协议与 MCP Client 交互，用户只需配置服务地址即可使用。
将 MCP 工具调用转换为标准的 HTTP 请求/响应，开发者可以使用任意编程语言实现，无需关注 SSE 协议细节。

📄 许可证

MIT

贡献

欢迎提交问题和 Pull Request！

mcp-server-proxy-op5