MCP Net

🚀 MCP 工具

本仓库提供了一系列用于处理模型上下文协议（MCP）的实用工具，能有效助力 MCP 相关任务的开展。

🚀 快速开始

MCP 代理

MCP 代理能将从标准输入读取的数据，精准转发到指定的 HTTP 端点，并把响应输出至标准输出，实现与远程兼容服务器的便捷通信。

MCP 服务器

MCP 服务器可加载并管理目录中的 MCP 可执行文件，通过 HTTP 或标准输入输出将其提供给客户端。

使用 Makefile 构建和运行

项目中的 Makefile 极大简化了组件的构建与运行流程。

✨ 主要特性

MCP 代理

• 实现请求到 HTTP 端点的转发，便于与远程服务器通信。
• 使用 Go 语言编写，编译为单个可执行文件，减少部署和运行问题。

MCP 服务器

• 支持从目录加载 MCP 可执行文件，并通过 HTTP 或标准输入输出提供服务。
• 能按 MCP 名称对工具进行命名空间分隔，清晰展示工具列表。

Makefile

• 简化构建和运行过程，可构建所有组件或特定组件。
• 支持多种运行模式，如 HTTP 模式和标准输入输出模式。

📦 安装指南

本项目不需要额外的安装步骤，使用 Makefile 即可完成构建。

构建

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

make

或者仅构建特定组件：

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

💻 使用示例

MCP 代理

基础用法

./mcp-proxy [选项]

选项说明

高级用法

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

MCP 服务器

基础用法

./mcp-server [选项]

选项说明

使用 Makefile 运行

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

make run-server

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

make run-server-stdio

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

make run-proxy

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

make build && make run

📚 详细文档

MCP 目录结构

服务器要求目录中包含可执行文件，每个可执行文件需实现使用标准输入输出的 MCP 协议。服务器会按以下步骤处理：

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

📄 许可证

本项目遵循 MIT 许可证授权。