MCP 接入点

MCP 接入点是一个轻量级的网关工具，旨在桥接传统的 HTTP 服务和 MCP (模型上下文协议) 客户端。它使得 MCP 客户端和现有的 HTTP 服务之间能够无缝交互，而无需修改服务器端的接口代码。

<p align="center"> <a href="./README.md"><img alt="README in English" src="https://img.shields.io/badge/English-d9d9d9"></a> <a href="./README_CN.md"><img alt="简体中文版自述文件" src="https://img.shields.io/badge/简体中文-d9d9d9"></a>

</p>

快速开始

安装方法

# 从源码安装
git clone https://github.com/sxhxliang/mcp-access-point.git
cd mcp-access-point
# 传入 openapi.json 文件路径、mcp 端口号和上游服务地址
cargo run -- -f openapi_for_demo.json -p 8080 -u localhost:8090
# 使用 inspector 进行调试。首先，启动服务。
npx @modelcontextprotocol/inspector@0.8.1 node build/index.js
# 访问 http://127.0.0.1:6274/
# 选择 "see"，填写 0.0.0.0:8080/sse，然后点击 "connect" 连接到服务。

参数分解：

1. -f openapi_for_demo.json

   • -f (或 --file) 指定 OpenAPI 规范文件的路径 (openapi_for_demo.json)。
   • 此文件定义了 MCP (模型上下文协议) 接入点将使用的 API。

2. -p 8080

   • -p (或 --port) 设置 MCP 接入点监听传入请求的端口号 (8080)。

3. -u localhost:8090

   • -u (或 --upstream) 定义上游服务地址 (localhost:8090)。
   • MCP 接入点将在处理请求后将其转发到此地址。

主要特点：

• 协议转换：在 HTTP 和 MCP 协议之间双向转换
• 零修改：与现有的 HTTP 服务直接配合使用
• 客户端启用：允许 MCP 客户端使用标准的 HTTP 服务
• 轻量级代理：以最小的开销进行清晰的协议转换

该解决方案尤其适用于：

• 逐步将 HTTP 服务迁移到 MCP 架构
• 使基于 MCP 的系统能够利用现有的 HTTP 基础设施
• 构建需要支持两种协议的混合系统

用例示例： 一个具有 MCP 原生客户端的 AI 服务需要与基于传统 HTTP 的微服务集成。 MCP 接入点位于它们之间，透明地处理协议转换。

您希望我进一步开发此描述的任何特定方面吗，例如技术架构或特定协议转换细节？