Snappy MCP Server With Xano Integration

🚀 Snappy MCP サーバーと Xano の統合

Cloudflare Workers を基盤として構築されたリモート MCP サーバーで、ツール管理、セッション追跡、OAuth のために Xano データベースと統合されています。最新バージョンのストリーミング 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. サーバーのログを確認して、詳細な情報を取得します。