这个项目是一个 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'): 复制指定页面,并为其指定新的名称。

安装步骤:

  1. 确保您的系统中已安装 Node.js 和 pnpm。
  2. 克隆该 GitHub 仓库到您的本地计算机。
  3. 打开终端,进入克隆下来的项目目录。
  4. 运行命令 'pnpm install' 安装项目所需的全部依赖。
  5. 运行命令 '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 响应的形式返回给客户端。

信息

分类

生产力应用