Coda MCP

🚀 Coda モデルコンテキストプロトコル (MCP) サーバー

このプロジェクトは、モデルコンテキストプロトコル (MCP) サーバーを実装しており、Coda API とのインタラクションのためのブリッジとして機能します。これにより、MCP クライアント（例えば人工知能アシスタント）が特定の Coda ドキュメントに対して、ページの一覧表示、作成、読み取り、更新、複製、および名前変更などの操作を実行できます。

✨ 主な機能

このサーバーは、MCP クライアントに以下のツールを公開しています。

• list-pages：設定された Coda ドキュメント内のすべてのページを一覧表示します。
• create-page：ドキュメント内に新しいページを作成し、必要に応じて初期の Markdown コンテンツで埋めることができます。
• get-page-content：ID または名前で指定されたページのコンテンツを（Markdown として）取得します。
• replace-page-content：指定されたページのコンテンツを新しい Markdown コンテンツで置き換えます。
• append-page-content：指定されたページの末尾に新しい Markdown コンテンツを追加します。
• duplicate-page：既存のページを複製し、新しい名前でコピーを作成します。
• rename-page：既存のページの名前を変更します。

📦 インストール

Cursor/Claude Desktop などのツールに MCP サーバーを追加するには、以下の実行コマンドを使用します。

npx -y coda-mcp@latest

例えば、Cursor/Claude Desktop では、以下のように追加できます。

{
  "mcpServers": {
    "coda": {
      "command": "npx",
      "args": ["-y", "coda-mcp@latest"],
      "env": {
        "API_KEY": "...",
        "DOC_ID": "..."
      }
    }
  }
}

必要な環境変数

• API_KEY：あなたの Coda API キーです。Coda アカウント設定で生成できます。
• DOC_ID：サーバーが操作する Coda ドキュメントの ID です。ドキュメントの URL 内（_d の後の部分）に見つけることができます。

💻 使用例

基本的な使用法

MCP サーバーを Cursor/Claude Desktop などのツールに追加するためのコマンドは以下の通りです。

npx -y coda-mcp@latest

高度な使用法

Cursor/Claude Desktop での具体的な追加設定例です。

{
  "mcpServers": {
    "coda": {
      "command": "npx",
      "args": ["-y", "coda-mcp@latest"],
      "env": {
        "API_KEY": "...",
        "DOC_ID": "..."
      }
    }
  }
}

🔧 技術詳細

ローカル環境の設定

1. 前提条件:

   • Node.js
   • pnpm

2. リポジトリをクローンする:

   git clone <repository-url>
   cd coda-mcp
   

3. 依存関係をインストールする:

   pnpm install
   

4. プロジェクトをビルドする:

   pnpm build
   

   これにより、TypeScript コードが JavaScript にコンパイルされ、dist/ ディレクトリに出力されます。

サーバーの起動

MCP サーバーは標準入出力（stdio）を介して通信します。サーバーを起動するには、環境変数を設定し、コンパイルされた JavaScript ファイル dist/index.js を実行します。

開発に関する注意事項

• コード規約: pnpm lint
• フォーマット: pnpm format
• OpenAPI クライアントの生成: pnpm openapi-ts（Coda API 仕様が変更された場合）