项目简介

MCP Connect 是一个轻量级的工具，旨在解决云端 AI 应用访问本地 Stdio 协议 MCP 服务器的问题。它充当桥梁，将云端发起的 HTTP/HTTPS 请求转换为 Stdio 通信，使得云端服务能够安全、灵活地利用本地 MCP 服务器的资源和功能。

主要功能点

云端集成： 让云端 AI 服务能够与本地 Stdio 协议的 MCP 服务器交互。
协议转换： 将云端 HTTP/HTTPS 请求转换为本地 MCP 服务器可以理解的 Stdio 协议。
安全访问： 在保障安全的前提下，实现云端对本地资源的访问控制。
灵活扩展： 无需修改现有 MCP 服务器，即可轻松集成云端能力。
易于使用： 本地部署 MCP Connect 桥接服务，零代码侵入。
内置隧道： 可选支持 Ngrok 隧道，方便快速暴露本地服务到公网。

安装步骤

克隆仓库：

git clone https://github.com/EvalsOne/MCP-connect.git
cd MCP-connect

配置环境变量： 复制 '.env.example' 文件为 '.env'，并根据需要配置端口 'PORT' 和认证令牌 'AUTH_TOKEN'。如果需要使用 Ngrok 隧道，请配置 'NGROK_AUTH_TOKEN'。
```
cp .env.example .env
```
安装依赖：
```
npm install
```

启动 MCP Connect：

# 构建并启动生产模式
npm run build
npm run start

# 或，启动开发模式（支持热重载）
npm run dev

# 启动生产模式并使用 Ngrok 隧道
npm run start:tunnel

# 启动开发模式并使用 Ngrok 隧道
npm run dev:tunnel

启动成功后，MCP Connect 桥接服务将在 'http://localhost:3000/bridge' 运行。如果使用了 Ngrok 隧道，公网访问 URL 将在控制台输出。

服务器配置 (MCP 客户端配置)

对于需要连接 MCP Connect 桥接服务的 MCP 客户端，您需要配置 MCP 服务器的访问方式。由于 MCP Connect 作为一个桥梁，它自身并不直接托管资源或工具，而是将请求转发到您指定的 MCP 服务器。因此，在 MCP 客户端中，您需要将 MCP Connect 的桥接服务地址配置为 "MCP 服务器"。

以下是一个配置示例，假设您的 MCP Connect 桥接服务运行在 'http://your_domain/bridge'：

{
  "serverName": "MCP-Connect-Bridge",
  "command": "curl",
  "args": [
    "-X", "POST",
    "-H", "Content-Type: application/json",
    "-d", "@{request_body_file}",
    "http://your_domain/bridge"
  ]
}

配置说明:

'serverName': 为您的 MCP 服务器配置一个名称，方便在客户端中识别。例如 "MCP-Connect-Bridge"。
'command': 设置为 'curl'，用于发送 HTTP POST 请求。
'args': 'curl' 命令的参数列表。
- '"-X", "POST"': 指定 HTTP 请求方法为 POST。
- '"-H", "Content-Type: application/json"': 设置请求头，指定内容类型为 JSON。
- '"-d", "@{request_body_file}"': 关键参数。 '@{request_body_file}' 是一个占位符，会被 MCP 客户端自动替换为实际的 JSON-RPC 请求内容。
- '"http://your_domain/bridge"': 关键参数。请将 'http://your_domain/bridge' 替换为 您实际部署的 MCP Connect 桥接服务的 URL 地址。

重要提示:

上述配置示例假设 MCP 客户端支持使用命令行工具（如 'curl'）作为 MCP 服务器的连接方式，并通过 '${request_body_file}' 或类似的占位符传递请求体。 请务必参考您使用的 MCP 客户端的文档，确认其支持这种配置方式，并根据客户端的要求进行调整。
如果 MCP Connect 服务启用了 'AUTH_TOKEN' 认证，您需要在 MCP 客户端的配置中添加相应的 'Authorization' 请求头。具体的添加方式同样需要参考 MCP 客户端的文档。

基本使用方法

启动 MCP Connect 桥接服务 (按照安装步骤操作)。
配置 MCP 客户端，将 MCP Connect 桥接服务的地址配置为 "MCP 服务器" (参考服务器配置部分)。
在云端 AI 应用中使用 MCP 客户端，即可通过 MCP Connect 桥接服务，访问本地 Stdio MCP 服务器的功能。

关键词

项目简介

主要功能点

安装步骤

服务器配置 (MCP 客户端配置)

基本使用方法

信息