Snappy MCP Server With Xano Integration

🚀 Snappy MCP 服务器与 Xano 集成

Snappy MCP 服务器是一个基于 Cloudflare Workers 构建的远程 MCP 服务器，它集成了 Xano 数据库，可用于工具管理、会话跟踪和 OAuth。该服务器现已全面支持 2024 年 11 月 5 日发布的最新版本流式 HTTP 传输协议。

🚀 快速开始

本地开发

以下是在本地开发环境搭建 Snappy MCP 服务器的步骤：

# 克隆仓库
git clone https://github.com/roboulos/remote-mcp-server.git

# 进入项目目录
cd remote-mcp-server

# 安装依赖项
npm install

# 启动服务器
npm run dev

本地调用 MCP 服务器

在本地环境中调用 MCP 服务器，可使用以下命令：

npx @modelcontextprotocol/inspector@latest

在 Inspector 中，输入本地 IP 地址和端口（例如：http://localhost:8787/sse），然后点击“连接”。

连接 Claude Desktop 到本地 MCP 服务器

更新 Claude 的配置文件（通常位于 ~/.config/claude/mcp-servers.json）：

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

重启 Claude 后，它将能够连接到本地 MCP 服务器。

部署到 Cloudflare

若要将服务器部署到 Cloudflare，可按以下步骤操作：

1. 创建 KV 空间：

   npx wrangler kv namespace create OAUTH_KV
   

2. 将 KV 空间 ID 添加到 wrangler.jsonc 文件中。
3. 在 wrangler.jsonc 中添加你的 Xano API 密钥。
4. 部署代码：

   npm run deploy
   

调用远程 MCP 服务器

从命令行调用远程 MCP 服务器，可使用以下命令：

npx mcp-remote https://worker-name.account-name.workers.dev/sse

如果出现问题，可以尝试清除 ~/.mcp-auth 文件：

rm -rf ~/.mcp-auth

📦 Xano 项目设置

在 Xano 项目中，需要创建以下 API 端点：

1. /api/tools - GET - 获取所有工具列表。
2. /api/tools/execute/{tool_name} - POST - 执行特定工具。
3. /api/sessions - POST - 创建新会话。
4. /api/sessions/update-activity - PUT - 更新会话活动。
5. /api/logs - POST - 记录 MCP 请求日志。

🔧 问题排查

如果遇到连接问题，请尝试以下步骤：

1. 确保服务器正在运行。
2. 检查网络配置，确保没有防火墙阻止相关端口。
3. 查看服务器日志以获取更多信息。