MCP Net

🚀 MCP 工具

本仓库提供了一系列用于处理模型上下文协议（MCP）的工具，能够高效地实现请求转发、可执行文件管理等功能，为 MCP 相关操作提供便利。

🚀 快速开始

MCP 代理

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

MCP 服务器

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

使用 Makefile 构建和运行

项目包含的 Makefile 可简化组件的构建与运行过程。

✨ 主要特性

MCP 代理

• 请求转发：将标准输入的数据转发到指定 HTTP 端点。
• 简单易用：实现简单的代理功能，便于与远程服务器通信。
• Go 语言编写：编译为单个可执行文件，减少部署和运行问题。

MCP 服务器

• 可执行文件管理：从目录中加载 MCP 可执行文件并提供给客户端。
• 工具列表返回：客户端请求时，返回所有已加载 MCP 提供的工具。
• 多模式运行：支持 HTTP 模式和标准输入模式。

Makefile

• 简化构建：可构建所有组件或特定组件。
• 便捷运行：提供多种运行模式，方便启动服务器和代理。

📦 安装指南

本项目无需复杂的安装步骤，可通过 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 服务器

make run-server

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

make run-server-stdio

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

make run-proxy

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

make build && make run

📚 详细文档

MCP 目录结构

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

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

📄 许可证

本项目采用 MIT 许可证授权。