Coda MCP

🚀 Coda 模型上下文协议 (MCP) 服务器

本项目实现了一个模型上下文协议（MCP）服务器，它充当与 Coda API 交互的桥梁。借助该服务器，MCP 客户端（如人工智能助手）能够对特定的 Coda 文档执行各类操作，像列出、创建、读取、更新、复制和重命名页面等。

🚀 快速开始

将 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 后的部分）。

✨ 主要特性

该服务器向 MCP 客户端公开以下工具：

• list-pages：列出配置的 Coda 文档中的所有页面。
• create-page：在文档中创建新页面，可选地使用初始 Markdown 内容进行填充。
• get-page-content：按 ID 或名称检索指定页面的内容（作为 Markdown）。
• replace-page-content：用新的 Markdown 内容替换指定页面的内容。
• append-page-content：在指定页面的末尾追加新 Markdown 内容。
• duplicate-page：复制现有页面并以新名称创建副本。
• rename-page：重命名现有页面。

📦 安装指南

本地配置

1. 先决条件:
   • Node.js
   • pnpm
2. 克隆仓库:

   git clone <repository-url>
   cd coda-mcp
   

3. 安装依赖项:

   pnpm install
   

4. 构建项目:

   pnpm build
   

   这将编译 TypeScript 代码为 JavaScript，并输出到 dist/ 目录。

💻 使用示例

基础用法

将 MCP 服务器添加到工具中的执行命令：

npx -y coda-mcp@latest

在 Cursor/Claude Desktop 中添加服务器的配置示例：

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

高级用法

在本地配置服务器时的操作步骤：

# 克隆仓库
git clone <repository-url>
cd coda-mcp
# 安装依赖项
pnpm install
# 构建项目
pnpm build

🔧 技术细节

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

开发相关

• 代码规范: pnpm lint
• 格式化: pnpm format
• OpenAPI 客户端生成: pnpm openapi-ts（如果 Coda API 规范发生变化）