Impact MCP Server

🚀 在Cloudflare上远程搭建MCP服务器

本项目可以让你在Cloudflare Workers上启动一个远程MCP服务器，并集成OAuth登录功能，为相关应用提供服务支持。

🚀 快速开始

📦 安装指南

本地开发

# 克隆仓库
git clone git@github.com:cloudflare/ai.git

# 安装依赖
cd ai
npm install

# 启动本地服务
npx nx dev remote-mcp-server

启动本地服务后，你可以通过浏览器打开http://localhost:8787/进行访问。

💻 使用示例

将MCP Inspector连接到你的服务器

要探索新的MCP API，你可以使用MCP Inspector，具体步骤如下：

• 使用命令npx @modelcontextprotocol/inspector启动它。
• 在Inspector中，切换传输类型为SSE，并在URL栏输入http://localhost:8787/sse，然后点击“连接”。
• 你会进入一个模拟的登录界面，输入任意电子邮件和密码即可完成登录。
• 成功登录后，你可以在MCP Inspector中列出并调用任何已定义的工具！

将Claude Desktop连接到本地MCP服务器

为了让Claude能够使用这个MCP服务器，你需要修改Claude的配置文件。按照Anthropic的快速入门指南，在Claude Desktop中进入设置 > 开发者 > 编辑配置，找到你的配置文件。 用文本编辑器打开该文件，并将其替换为以下内容：

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"
      ]
    }
  }
}

这样，Claude将通过本地代理与你的MCP服务器通信。 启动Claude后，浏览器窗口会打开，并提示你登录。完成登录后，你可以在右下角看到可用工具列表。根据提示输入合适的指令，Claude将调用相应的工具来执行任务。

🚀 部署到Cloudflare

1. npx wrangler kv namespace create OAUTH_KV
2. 根据提示将KV命名空间ID添加到wrangler.jsonc文件中。
3. 执行命令npm run deploy完成部署。

从远程MCP客户端调用新部署的服务器

在成功部署后，你可以通过以下步骤使用新的MCP服务器：

1. 更新你的配置文件以指向正确的URL和凭据。
2. 使用相应的工具或脚本与新部署的MCP服务器进行交互。

🔧 调试

以下命令可以帮助你完成调试：

# 重启服务
npx nx dev remote-mcp-server

# 清除缓存
rm -rf node_modules && npm install

这些步骤将帮助你快速排查问题并确保服务正常运行。