Coda MCP Server

Coda MCP サーバー

このプロジェクトは、Coda API と連携するブリッジとして機能する Model Context Protocol（MCP）サーバーを実装しています。MCP クライアント（AI アシスタントなど）から、Coda ページの一覧表示、作成、読み取り、更新、複製、名前変更などの操作を実行できます。

メモ

この MCP サーバーは Coda が開発または保守しているものではなく、コミュニティによって構築されたプロジェクトです。

機能

サーバーは、MCP クライアントに次のツールを公開します。

• coda_list_documents: ユーザーが利用できるすべてのドキュメントを一覧表示します。
• coda_list_pages: ページネーションに対応し、設定された Coda ドキュメント内のすべてのページを一覧表示します。
• coda_create_page: ドキュメント内に新しいページを作成します。指定した親ページの下にサブページとして作成することや、初期の Markdown コンテンツを追加することもできます。
• coda_get_page_content: 指定したページ（ID または名前）のコンテンツを Markdown 形式で取得します。
• coda_replace_page_content: 指定したページのコンテンツを新しい Markdown コンテンツに置き換えます。
• coda_append_page_content: 指定したページの末尾に新しい Markdown コンテンツを追加します。
• coda_duplicate_page: 既存のページを新しい名前で複製します。
• coda_rename_page: 既存のページの名前を変更します。
• coda_peek_page: ページの冒頭を確認し、指定した行数を返します。
• coda_resolve_link: Coda オブジェクトへのブラウザーリンクからメタデータを解決します。
• coda_list_tables: ドキュメント内のテーブルを一覧表示します。
• coda_list_columns: テーブル内の列を一覧表示します。
• coda_list_rows: オプションのフィルタリングと並べ替えに対応し、テーブル内の行を一覧表示します。
• coda_get_row: テーブルから単一の行を取得します。
• coda_upsert_rows: テーブルに行を挿入またはアップサートします。
• coda_update_row: テーブル内の単一の行を更新します。
• coda_delete_row: テーブル内の単一の行を削除します。
• coda_delete_rows: テーブル内の複数の行を削除します。
• coda_push_button: テーブル内の行にあるボタン列を押します。

使用方法

次のようにして、MCP サーバーを Cursor／Claude Desktop などに追加します。

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

必須の環境変数：

• API_KEY：Coda API キーです。Coda アカウントの設定から生成できます。

この MCP サーバーは、次のように Docker でも利用できます。

{
  "mcpServers": {
    "coda": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "API_KEY", "reaperberri/coda-mcp:latest"],
      "env": {
        "API_KEY": "..."
      }
    }
  }
}

ローカル環境のセットアップ

1. 前提条件：

   • Node.js
   • pnpm

2. リポジトリをクローンします：

   git clone <repository-url>
   cd coda-mcp
   

3. 依存関係をインストールします：

   pnpm install
   

4. プロジェクトをビルドします：

   pnpm build
   

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

サーバーの実行

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