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. 查看服務器日誌以獲取更多信息。