Coda MCP 服务器

该项目实现了一个模型上下文协议 (MCP) 服务器，作为与Coda API 交互的桥梁。它允许 MCP 客户端（例如 AI 助手）对特定的 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 ：重命名现有页面。

Related MCP server: Confluence MCP

用法

将 MCP 服务器添加到 Cursor/Claude Desktop/etc. 像这样：

所需的环境变量：

• API_KEY ：您的 Coda API 密钥。您可以从 Coda 帐户设置中生成一个。

此 MCP 服务器也可与 Docker 一起使用，如下所示：

本地设置

1. 先决条件：

   • Node.js

   • 下午

2. 克隆存储库：

   git clone <repository-url> cd coda-mcp

3. 安装依赖项：

   pnpm install

4. 构建项目：

   pnpm build

   这会将dist/目录中的 TypeScript 代码编译为 JavaScript。

运行服务器

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

发展

• 代码检查： pnpm lint

• 格式化： pnpm format

• OpenAPI 客户端生成： pnpm openapi-ts （如果 Coda API 规范发生变化）