Snappy MCP Server With Xano Integration

🚀 Snappy MCP 服务器与 Xano 集成

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

🚀 快速开始

📦 安装指南

本地开发环境搭建

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

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

# 安装依赖项
npm install

# 启动服务器
npm run dev

💻 使用示例

本地调用 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

1. 创建 KV 空间：

   npx wrangler kv namespace create OAUTH_KV
   

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

   npm run deploy
   

调用远程 MCP 服务器

从命令行调用：

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

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

rm -rf ~/.mcp-auth

📚 详细文档

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. 查看服务器日志以获取更多信息。