MCP 工具

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

MCP 代理

一个将请求转发到 HTTP 端点的 MCP 代理。

概述

MCP 代理将从标准输入读取的数据转发到指定的 HTTP 端点，并将响应输出到标准输出。它实现了一个简单的代理，可用于与远程兼容的服务器通信。

为何使用 Go 语言？

此代码在客户端运行。许多语言需要安装正确的运行时环境和库。Go 编译为单个可执行文件。这减少了部署困难、用户支持请求、运行时或版本更新等问题，转而提供一个 HTTP 端点。

使用方法

./mcp-proxy [选项]

选项

• -endpoint：要代理的 HTTP 端点地址（默认："http://localhost:8080"）
• -content-type：HTTP 请求的内容类型头（默认："application/json"）
• -timeout：HTTP 请求超时时间，以秒为单位（默认：30）
• -buffer：从标准输入读取的缓冲区大小，单位为 KB（默认：64）

示例

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

MCP 服务器

一个加载并管理来自目录中的 MCP 可执行文件并通过 HTTP 或标准输入输出将它们暴露给客户端的服务器。

概述

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

使用方法

./mcp-server [选项]

选项

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

MCP 目录结构

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

1. 扫描目录中的可执行文件
2. 运行每个可执行文件以发现它提供的工具
3. 将这些工具按命名空间名称（mcpname.toolname）提供给客户端

使用 Makefile 构建和运行

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

构建

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

make

或者仅构建特定组件：

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

运行

以 HTTP 模式启动 MCP 服务器（需要先构建示例并将它们复制到 mcps 目录）：

make run-server

以标准输入输出模式启动 MCP 服务器：

make run-server-stdio

通过代理连接到本地 MCP 服务器：

make run-proxy

示例

构建所有组件并运行服务器和代理：

make build && make run

许可证

本项目由 MIT 许可证授权。