MCP 工具

此仓库包含用于处理模型上下文协议 (MCP) 的工具。

MCP 代理

一个用于模型上下文协议的代理，将请求转发到 HTTP 端点。

概述

MCP 代理将来自 stdin 的数据转发到指定的 HTTP 端点，并将响应返回到 stdout。 它实现了一个简单的代理，可用于与远程 MCP 兼容的服务器通信。

为什么选择 golang？

此代码在客户端运行。 许多语言需要安装运行时和正确的库才能执行此操作。 Go 编译成单个可执行文件。 这减少了部署困难、用户支持请求、运行时中断更新或其他通常通过提供 http 端点而不是部署来解决的问题。

用法

./mcp-proxy [选项]

选项

• -endpoint: 要将请求代理到的 HTTP 端点（默认值："http://localhost:8080"）
• -content-type: HTTP 请求的 Content-Type 标头（默认值："application/json"）
• -timeout: HTTP 请求超时时间（秒）（默认值：30）
• -buffer: 从 stdin 读取的缓冲区大小（KB）（默认值：64）

示例

./mcp-proxy -endpoint="https://api.example.com/mcp" -content-type="application/json"

MCP 服务器

一个服务器，从目录加载和管理 MCP 可执行文件，并通过 HTTP 或 stdio 将它们暴露给客户端。

概述

MCP 服务器从目录加载 MCP 可执行文件，并将它们提供给客户端。 当客户端请求工具列表时，服务器返回来自所有已加载 MCP 的所有工具，并按 MCP 名称进行命名空间划分。 服务器可以在 HTTP 模式或 stdio 模式下运行。

用法

./mcp-server [选项]

选项

• -mcp-dir: 包含 MCP 可执行文件的目录（默认值："./mcps"）
• -http: HTTP 服务器地址（默认值：":8080"）
• -name: MCP 服务器的名称（默认值："MCP Server"）
• -version: MCP 服务器的版本（默认值："1.0.0"）
• -stdio: 使用 stdio 而不是 HTTP（默认值：false）

MCP 目录结构

服务器期望一个包含 MCP 可执行文件的目录。 每个可执行文件必须使用 stdio 实现 MCP 协议。 服务器将：

1. 扫描目录中的可执行文件
2. 运行每个可执行文件以发现它提供的工具
3. 使这些工具可供客户端使用，并使用命名空间名称 (mcpname.toolname)

使用 Make 构建和运行

此项目包含一个 Makefile，可简化组件的构建和运行。

构建

构建所有组件（代理、服务器和示例）：

make

或者构建特定组件：

make build-proxy    # 仅构建代理
make build-server   # 仅构建服务器
make build-examples # 仅构建示例 MCP

运行

在 HTTP 模式下启动 MCP 服务器（在构建示例并将其复制到 mcps 目录后）：

make run-server

在 stdio 模式下启动 MCP 服务器：

make run-server-stdio

运行代理以连接到本地 MCP 服务器：

make run-proxy

测试

使用基本的 tools/list 请求测试代理（需要服务器运行）：

make test-proxy

通过代理测试特定的示例工具（需要服务器运行）：

make test-hello   # 测试 hello 工具
make test-add     # 测试计算器的 add 工具

示例 MCP

该仓库包含示例 MCP，演示了如何实现 MCP 兼容的工具：

• hello-mcp: 一个提供 "hello" 工具的简单 MCP
• calculator-mcp: 一个提供数学运算的 MCP

构建示例并将其安装到 mcps 目录：

make examples

开发任务

格式化 Go 代码：

make fmt

运行 Go vet 进行代码分析：

make vet

更新和整理 Go 依赖项：

make tidy

清理构建工件：

make clean

将二进制文件安装到 GOPATH/bin：

make install

许可证

MIT