Coda MCP Server

Coda MCP 服务

此项目实现了一个模型上下文协议（MCP）服务，作为与 Coda API 交互的桥梁。它允许 MCP 客户端（例如 AI 助手）对 Coda 页面执行操作，例如列出、创建、读取、更新、复制和重命名。

说明

此 MCP 服务并非由 Coda 开发或维护，而是由社区构建的项目。

功能

此服务向 MCP 客户端提供以下工具：

• coda_list_documents：列出用户可访问的所有文档。
• coda_list_pages：列出已配置的 Coda 文档中的所有页面，并支持分页。
• coda_create_page：在文档中创建新页面，可选择将其置于指定的父页面下（创建子页面），并填入初始 Markdown 内容。
• coda_get_page_content：以 Markdown 格式获取指定页面（通过 ID 或名称指定）的内容。
• 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 代码编译为 JavaScript，并输出到 dist/ 目录。

运行服务

MCP 服务通过标准输入/输出（stdio）通信。要运行它，请设置环境变量并运行编译后的 JavaScript 文件 dist/index.js。