这个项目是一个 Model Context Protocol (MCP) 服务器,旨在作为 LLM 客户端(如 AI 助手)与 Coda API 之间的桥梁。它允许 MCP 客户端以结构化的方式访问和操作指定的 Coda 文档,从而将 Coda 文档的能力集成到 AI 工作流程中。
主要功能点:
- 列出页面 ('list-pages'): 获取指定 Coda 文档中的所有页面列表。
- 创建页面 ('create-page'): 在文档中创建一个新页面,可以选定父页面并填充初始 Markdown 内容。
- 获取页面内容 ('get-page-content'): 根据页面 ID 或名称获取页面的 Markdown 格式内容。
- 更新页面 ('update-page'): 根据页面 ID 或名称,替换或追加页面的 Markdown 内容。
- 复制页面 ('duplicate-page'): 复制指定页面,并为其指定新的名称。
安装步骤:
- 确保您的系统中已安装 Node.js 和 pnpm。
- 克隆该 GitHub 仓库到您的本地计算机。
- 打开终端,进入克隆下来的项目目录。
- 运行命令 'pnpm install' 安装项目所需的全部依赖。
- 运行命令 'pnpm build' 编译 TypeScript 代码。编译后的 JavaScript 文件将位于 'dist/' 目录下。
服务器配置:
该 MCP 服务器需要连接到 Coda API 并指定操作的文档。您需要通过环境变量提供以下信息:
- 'API_KEY': 您的 Coda API 密钥,用于验证和授权访问 Coda API。您可以在 Coda 账户设置中生成此密钥。
- 'DOC_ID': 您希望该 MCP 服务器交互的 Coda 文档的 ID。此 ID 可以在文档的浏览器 URL 中找到(通常是 'd/' 后面的那部分)。
在 MCP 客户端(如 Cursor 或 Claude Desktop)中配置此服务器时,您需要指定服务器的启动方式和这些环境变量。通常,配置会包含服务器名称、启动命令 ('command')、命令参数 ('args') 和环境变量 ('env')。例如,您可以将 'command' 设置为 'npx','args' 设置为 '['coda-mcp@latest']',并在 'env' 部分添加 'API_KEY' 和 'DOC_ID' 及其对应的值。
基本使用方法:
该服务器设计为通过标准输入/输出 (stdio) 运行,与 MCP 客户端进行通信。配置完成后,当 MCP 客户端需要与 Coda 文档交互时,会启动该服务器进程并通过 JSON-RPC 协议向其发送请求(例如,调用上述的主要功能点)。服务器接收请求,执行相应的 Coda API 调用,并将结果以 JSON-RPC 响应的形式返回给客户端。
信息
分类
生产力应用