MCP Server for Cursor Integration

Cursor 連携用 MCP サーバー

Cursor と Coda.io のドキュメントを連携する Managed Context Provider（MCP）サーバーです。Coda.io のドキュメントテーブルを検索して、コンテキストに応じた応答を提供します。

特徴

• Coda.io API との連携
• パフォーマンスを向上させるキャッシュシステム
• RESTful API エンドポイント
• 複数の Coda テーブルに対応
• ヘルスチェックおよびキャッシュ管理用エンドポイント

前提条件

• Node.js（v14 以上）
• API アクセスが可能な Coda.io アカウント
• 関連するテーブルを含む Coda.io ドキュメント

セットアップ

1. リポジトリをクローンします
2. 依存関係をインストールします：

   npm install
   

3. .env.example を基に .env ファイルを作成します：

   cp .env.example .env
   

4. Coda.io の認証情報を使用して .env ファイルを更新します：
   • CODA_API_TOKEN：Coda.io API トークン
   • CODA_DOC_ID：Coda.io ドキュメント ID

サーバーの起動

開発モード：

npm run dev

本番モード：

npm start

ngrok を使用したトンネリング

ngrok を使用してローカルサーバーをインターネットに公開するには、次の手順に従います：

1. ngrok をインストールします：

   npm install -g ngrok
   

2. MCP サーバーを起動します（別のターミナルで実行）：

   npm start
   

3. ローカルサーバーへのトンネルを作成します：

   ngrok http 3000
   

4. ngrok からパブリック URL（例：https://xxxx-xxxx-xxxx.ngrok-free.app）が提供されます

5. ngrok の URL を使用して mcp.json ファイルを更新します：

   {
     "mcpServers": {
       "Coda MCP": {
         "url": "https://xxxx-xxxx-xxxx.ngrok-free.app/context",
         "method": "POST",
         "headers": {
           "Content-Type": "application/json"
         }
       }
     }
   }
   

注：有料アカウントをお持ちでない場合、ngrok の URL は ngrok を再起動するたびに変わります。URL が変わったら、新しい URL を使用して mcp.json ファイルを更新してください。

API エンドポイント

コンテキストの取得

POST /context
Body: { "query": "your search query" }

ヘルスチェック

GET /health

キャッシュ管理

POST /cache/clear
GET /cache/stats

Coda.io 連携

サーバーは、Coda.io ドキュメントに次のテーブルがあることを想定しています：

• Jira チケット
• API ドキュメント
• アーキテクチャ上の決定事項

Coda.io ドキュメントの構成に合わせて、src/services/mcp.service.js 内のテーブル名を変更できます。

エラー処理

サーバーには、次の項目に対する包括的なエラー処理が含まれています：

• API リクエストの失敗
• 無効なクエリ
• キャッシュ管理
• サーバーエラー

コントリビューション

問題の報告や機能改善のリクエストをぜひお寄せください！