MCP-Remote 项目安装与配置指南

1. 项目基础介绍

MCP-Remote 是一个开源项目，旨在帮助用户将只支持本地（stdio）服务器的 MCP 客户端连接到远程 MCP 服务器，并支持认证功能。该项目是一个工作原理的验证概念，但仍然被视为实验性项目。MCP-Remote 可以在不需要在用户电脑上运行代码的情况下，安全地与世界共享 MCP 服务器。

该项目主要使用 JavaScript 作为编程语言。

2. 项目使用的关键技术和框架

• Node.js: 项目运行在 Node.js 环境中，Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行环境。
• OAuth: 用于认证和授权，使得客户端能够以安全的方式访问服务器资源。
• MCP (Message Collider Protocol): 一个消息传递协议，用于客户端和服务器之间的通信。

3. 项目安装和配置的准备工作

在开始安装之前，请确保您的系统中已经安装了以下软件：

• Node.js (版本 18 或更高)
• Git

如果尚未安装，您可以从官方网站下载并安装这些软件。

安装步骤

1. 克隆项目仓库

   打开命令行工具，运行以下命令克隆项目仓库：

   git clone https://github.com/geelen/mcp-remote.git
   

2. 安装依赖

   进入项目目录：

   cd mcp-remote
   

   然后，安装项目依赖：

   npm install
   

3. 配置 MCP 客户端

   根据您使用的 MCP 客户端（例如 Claude Desktop, Cursor 或 Windsurf），编辑相应的配置文件以添加远程 MCP 服务器。

   例如，对于 Claude Desktop，您需要编辑 claude_desktop_config.json 文件，该文件通常位于以下路径：

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   在配置文件中添加如下内容：

   {
     "mcpServers": {
       "remote-example": {
         "command": "npx",
         "args": ["mcp-remote", "https://remote.mcp.server/sse"]
       }
     }
   }
   

   对于其他客户端，如 Cursor 和 Windsurf，也需要在相应的配置文件中添加类似的配置。

4. 运行 MCP-Remote

   在命令行中，运行以下命令以启动 MCP-Remote：

   npx mcp-remote https://remote.mcp.server/sse
   

   如果需要，您可以通过添加参数来调整运行选项，例如指定端口或允许 HTTP 连接。

完成上述步骤后，您的 MCP 客户端应该能够连接到远程 MCP 服务器了。如果在配置过程中遇到问题，请检查日志文件或清除认证信息重试。