MCP Server - Coda.io

MCP Server - Coda.io

Coda の API とシームレスに統合し、ドキュメント、テーブル、データを管理するさまざまなツールを提供する Model Context Protocol（MCP）サーバーの実装です。

機能

• テーブル操作
  • ドキュメントからすべてのテーブルを取得
  • 特定のテーブルデータを取得
  • テーブルの列情報を取得
• 行の管理
  • テーブルから行を取得
  • 行をアップサート（挿入／更新）
  • 行を削除
• 列の操作
  • 特定の列の詳細を取得
  • 列のメタデータを取得

前提条件

• Node.js（v20 以降）
• Coda API キー
• TypeScript の知識（開発する場合）

環境設定

1. Replit でこのリポジトリをクローンまたはフォークします
2. ルートディレクトリに .env ファイルを作成します：

   PORT=8000
   CODA_API_KEY=your_coda_api_key_here
   

3. your_coda_api_key_here を実際の Coda API キーに置き換えます

インストール

このプロジェクトでは依存関係の管理に npm を使用します。依存関係をインストールするには：

npm install

プロジェクトのビルド

TypeScript ファイルを JavaScript にコンパイルします：

npx tsc

サーバーの実行

ビルド後、サーバーを起動します：

node dist/index.js

または、次のコマンドをまとめて実行します：

npm install && npx tsc && node dist/index.js

サーバーはデフォルトでポート 8000 で起動し、次のエンドポイントを利用できます：

• GET /sse - SSE 接続エンドポイント
• POST /messages - メッセージ処理エンドポイント

利用可能なツール

1. fetch-coda-docs

   • 利用可能なすべての Coda ドキュメントを取得します
   • 任意のパラメーター：isOwner、limit

2. fetch-coda-tables

   • 指定したドキュメントからすべてのテーブルを取得します
   • 必須パラメーター：docId

3. fetch-coda-table

   • ドキュメントから特定のテーブルを取得します
   • 必須パラメーター：docId、tableId

4. fetch-coda-table-columns

   • 特定のテーブルの列情報を取得します
   • 必須パラメーター：docId、tableId

5. fetch-coda-rows

   • 指定したテーブルから行を取得します
   • 必須パラメーター：docId、tableId

6. upsert-coda-rows

   • テーブルの行を挿入または更新します
   • 必須パラメーター：docId、tableId、rows

7. delete-coda-rows

   • テーブルから指定した行を削除します
   • 必須パラメーター：docId、tableId、rowIds

エラー処理

このサーバーでは、包括的なエラー処理を実装しています：

• 環境変数の検証
• API レスポンスの検証
• リクエストパラメーターの検証
• 適切なエラーメッセージとログ記録

開発

プロジェクトは次のような構成です：

src/
├── tools/           # Individual tool implementations
│   ├── fetch-coda-docs.tool.ts
│   ├── fetch-coda-tables.tool.ts
│   └── ...
└── index.ts        # Main server implementation

使用技術

• Express.js - Web フレームワーク
• @modelcontextprotocol/sdk - MCP の実装
• Zod - ランタイム型チェック
• dotenv - 環境設定

既知の制限事項と今後の改善

現在のツール実装には、いくつかの改善が必要です：

• JSON レスポンスの処理とフォーマットの強化
• 大規模なデータセット向けのページネーションの実装
• エラー処理と再試行メカニズムの改善
• レート制限の実装
• 大規模な操作向けのバッチ処理
• 頻繁にアクセスされるデータ向けのキャッシュ機構
• ドキュメントに基づいて実装すべき API ツールがまだあります

MCP クライアントの実装例

Cursor でこの MCP サーバーを実装する方法の例を紹介します：

1. Cursor の mcp.json で MCP サーバーを設定します：

2. Cursor の設定で利用可能なツールを有効にして使用します：

ライセンス

このプロジェクトは ISC License の下でライセンスされています。