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：重命名现有页面。

使用方法

将 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": "..."
      }
    }
  }
}

必要的环境变量

• API_KEY：您的 Coda API 密钥。您可以在 Coda 账户设置中生成。
• DOC_ID：Coda 文档的 ID，服务器将与其交互。您可以在文档的 URL 中找到（_d 后的部分）。

本地配置

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 规范发生变化）