Coda MCP Server

该项目实现了一个模型上下文协议（MCP）服务器，作为与Coda API交互的桥梁。它允许一个MCP客户端（如AI助手）对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对象的元数据。

使用方法

将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。