返回 MCP 目录
public公开dns本地运行

mcp-access-point

MCP Access Point是一个轻量级协议转换网关工具,用于在传统HTTP服务和MCP客户端之间建立通信桥梁,支持无需修改服务端接口即可实现协议转换。

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
  • 客户端可通过 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 接入网关充当中间层,实现协议间的无缝转换。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端