MCP-Gateway 项目使用教程

MCP-Gateway 项目使用教程

mcp-gateway A gateway demo for MCP SSE Server 项目地址: https://gitcode.com/gh_mirrors/mc/mcp-gateway

1. 项目的目录结构及介绍

MCP-Gateway 项目是一个开源项目，用于桥接基于 stdio 的 Model Context Protocol (MCP) 实现在 Claude Desktop 与基于 HTTP/SSE 的 MCP 服务器之间。以下是项目的目录结构及其介绍：

mcp-gateway/
├── src/                       # 源代码目录
├── LICENSE                    # 项目许可证文件
├── README.md                  # 项目说明文件
├── package-lock.json          # npm 依赖锁定文件
├── package.json               # npm 项目配置文件
└── tsconfig.json              # TypeScript 配置文件

• src/: 源代码目录，包含了项目的主要 JavaScript 或 TypeScript 代码。
• LICENSE: 项目使用的许可证文件，本项目采用 Apache-2.0 许可证。
• README.md: 项目说明文件，提供了项目的概述、安装、配置和使用方法。
• package-lock.json: npm 依赖锁定文件，确保在不同环境中安装相同的依赖版本。
• package.json: npm 项目配置文件，定义了项目的依赖、脚本和元数据。
• tsconfig.json: TypeScript 配置文件，用于配置 TypeScript 编译器的选项。

2. 项目的启动文件介绍

项目的启动文件通常是 src 目录下的主入口文件，可能是 mcphub-gateway.js。该文件负责初始化和启动 MCP-Gateway 服务。以下是启动文件的简要介绍：

• mcphub-gateway.js: 项目的入口文件，它将加载必要的依赖，设置服务器，并开始监听指定端口，等待客户端的连接。

要启动项目，你通常需要运行以下命令：

node src/mcphub-gateway.js

3. 项目的配置文件介绍

MCP-Gateway 项目的配置文件主要用于设置 Claude Desktop 与 MCP 服务器之间的连接。配置文件通常位于用户的主目录下，根据操作系统的不同路径会有所不同。

以下是配置文件的介绍：

• 在 macOS 系统上，配置文件通常位于 ~/Library/Application Support/Claude Desktop/config.json。
• 在 Windows 系统上，配置文件通常位于 %APPDATA%\Claude Desktop\config.json。

配置文件的内容可能如下所示：

{
  "mcpServers": {
    "server-name": {
      "command": "node",
      "args": ["/path/to/mcphub-gateway.js"]
    }
  }
}

在这里，你需要替换 "/path/to/mcphub-gateway.js" 为实际安装后 MCP-Gateway 的路径。此外，你还可以设置环境变量 MCP_SERVER_URL 来指定 MCP 服务器的 URL。如果不设置，默认会连接到 MCP Hub 服务器。

mcp-gateway A gateway demo for MCP SSE Server 项目地址: https://gitcode.com/gh_mirrors/mc/mcp-gateway