coda-mcp 是一个面向 Coda 的 Model Context Protocol(MCP)服务器,作为与 Coda API 交互的桥梁。它允许 MCP 客户端(例如 AI 助手)对 Coda 页面执行操作。该项目为社区构建,并非由 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 等客户端。所需环境变量为 API_KEY:你的 Coda API 密钥,可在 Coda 账户设置中生成。该 MCP 服务器也可通过 Docker 使用。
本地构建前提:Node.js 与 pnpm。步骤:克隆仓库(git clone <repository-url>,cd coda-mcp);安装依赖(pnpm install);构建项目(pnpm build),该命令将 TypeScript 代码编译为 dist/ 目录中的 JavaScript。
运行服务器:MCP 服务器通过标准输入/输出(stdio)通信。运行时设置环境变量并运行编译后的 JavaScript 文件 dist/index.js。
适用场景:需要在 AI 助手或 MCP 客户端中读写、组织和管理 Coda 文档、页面与表格数据的场景。
限制:项目为社区构建,非 Coda 官方开发或维护;需自行提供 Coda API 密钥;其他关于定价、平台支持范围等信息暂未提供。