🚀 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：重命名现有页面。
📦 安装指南
本地配置
- 先决条件：
- Node.js
- pnpm
- 克隆仓库：
git clone
cd coda-mcp
- 安装依赖项：
pnpm install
- 构建项目：
pnpm build
此操作会将 TypeScript 代码编译为 JavaScript，并输出到 dist/ 目录。
💻 使用示例
基础用法
MCP 服务器通过标准输入输出（stdio）进行通信。要运行它，请设置环境变量并执行编译后的 JavaScript 文件 - dist/index.js。
高级用法
在 Cursor/Claude Desktop 等工具中添加 MCP 服务器的配置示例：
{
"mcpServers": {
"coda": {
"command": "npx",
"args": ["-y", "coda-mcp@latest"],
"env": {
"API_KEY": "...",
"DOC_ID": "..."
}
}
}
}
🔧 技术细节
开发相关命令
- 代码规范：使用
pnpm lint来检查代码是否符合规范。 - 格式化：执行
pnpm format对代码进行格式化。 - OpenAPI 客户端生成：若 Coda API 规范发生变化，可使用
pnpm openapi-ts重新生成客户端。