article
README
🚀 MCP 接入点
MCP 接入点是一款轻量级的协议转换网关工具,它能在传统 HTTP 服务和 MCP(模型上下文协议)客户端之间搭建起通信桥梁。借助它,MCP 客户端可直接与现有的 HTTP 服务交互,无需对服务器端接口做任何修改。
🚀 快速开始
MCP 接入点基于 Pingora 构建,Pingora 是一个高性价比的网关代理库,能够支持大规模请求代理服务。它已被用于构建处理 Cloudflare 平台核心流量的服务,多年来一直稳定地为互联网上的 4000 多万次每秒的请求提供支持,是支撑 Cloudflare 平台上相当一部分流量的技术基础。
✨ 主要特性
HTTP 到 MCP
此模式允许像 Cursor Desktop 这样的客户端通过 SSE(Server-Sent Events)与远程 HTTP 服务器通信,即便这些服务器本身不支持 SSE 协议。
- 示例设置:
- 服务 1 在本地运行于
localhost:8000 - 服务 2 运行在云服务器上
example.com:9000
- 服务 1 在本地运行于
- 客户端可通过 MCP 接入点与这些 HTTP 服务交互,无需处理协议转换的复杂性。
核心功能
- 协议转换:无缝实现 HTTP 和 MCP 协议之间的转换。
- 零侵入式集成:与现有 HTTP 服务完全兼容。
- 客户端增强:赋能 MCP 客户端直接调用标准 HTTP 服务。
- 轻量级代理:架构简约,协议转换高效。
📦 安装指南
使用 Docker 运行
构建 Docker 镜像(可选)
# 克隆仓库
git clone https://github.com/sxhxliang/mcp-access-point.git
cd mcp-access-point
# 构建镜像
docker build -t liangshihua/mcp-access-point:latest .
启动 Docker 容器
# 使用环境变量(服务运行在主机上)
# 注意:请将 /path/to/your/config.yaml 替换为实际路径
docker run -d --name mcp-access-point --rm \
-p 8080:8080 \
-e port=8080 \
-v /path/to/your/config.yaml:/app/config/config.yaml \
sxhxliang/mcp-access-point:latest
环境变量
port:MCP 接入点侦听端口(默认:8080)
📚 详细文档
典型使用场景
- 逐步架构迁移:支持从 HTTP 向 MCP 的平滑过渡。
- 混合架构支持:在 MCP 生态系统中复用现有 HTTP 基础设施。
- 协议兼容性:构建同时支持两种协议的混合系统。
示例场景:当基于 MCP 的 AI 客户端需要与遗留的 HTTP 微服务接口时,MCP 接入网关充当中间层,实现协议间的无缝转换。
微信扫一扫