Coda MCP 服务器
该项目实现了一个模型上下文协议 (MCP) 服务器,作为与Coda API 交互的桥梁。它允许 MCP 客户端(例如 AI 助手)对特定的 Coda 文档执行操作,例如列出、创建、读取、更新、复制和重命名页面。
特征
服务器向 MCP 客户端公开以下工具:
list-pages
:列出配置的 Coda 文档中的所有页面。create-page
:在文档中创建一个新页面,可选择用初始 markdown 内容填充它。get-page-content
:以 markdown 形式检索指定页面的内容(按 ID 或名称)。replace-page-content
:用新的 markdown 内容替换指定页面的内容。append-page-content
:将新的 markdown 内容附加到指定页面的末尾。duplicate-page
:使用新名称创建现有页面的副本。rename-page
:重命名现有页面。
用法
使用以下执行命令将 MCP 服务器添加到 Cursor/Claude Desktop/等:
例如,在 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
之后的部分)中找到它。
本地设置
- 先决条件:
- 克隆存储库:
git clone <repository-url>
cd coda-mcp
- 安装依赖项:
- 构建项目:这会将
dist/
目录中的 TypeScript 代码编译为 JavaScript。
运行服务器
MCP 服务器通过标准输入/输出 (stdio) 进行通信。要运行它,请设置环境变量并运行已编译的 JavaScript 文件 - dist/index.js
。
发展
- 代码检查:
pnpm lint
- 格式化:
pnpm format
- OpenAPI 客户端生成:
pnpm openapi-ts
(如果 Coda API 规范发生变化)