MCP Server - Coda.io

一个模型上下文协议 (MCP) 服务器实现，用于与 Coda 的 API 无缝集成，提供各种文档、表格和数据管理工具。

功能

• 表格操作
  • 从文档中获取所有表格
  • 检索特定表格数据
  • 获取表格列信息
• 行管理
  • 从表格中获取行
  • Upsert (插入/更新) 行
  • 删除行
• 列操作
  • 获取特定列的详细信息
  • 获取列元数据

前提条件

• Node.js (v20 或更高版本)
• 一个 Coda API 密钥
• TypeScript 知识 (用于开发)

环境设置

1. 在 Replit 中克隆或 Fork 此存储库
2. 在根目录中创建一个 .env 文件：

   PORT=8000
   CODA_API_KEY=your_coda_api_key_here
   

3. 将 your_coda_api_key_here 替换为您的实际 Coda API 密钥

安装

该项目使用 npm 进行依赖管理。 要安装依赖项：

npm install

构建项目

将 TypeScript 文件编译为 JavaScript：

npx tsc

运行服务器

构建完成后，启动服务器：

node dist/index.js

或者使用组合命令：

npm install && npx tsc && node dist/index.js

服务器默认将在端口 8000 上启动，并提供以下端点：

• GET /sse - SSE 连接端点
• POST /messages - 消息处理端点

可用工具

1. fetch-coda-docs

   • 获取所有可用的 Coda 文档
   • 可选参数：isOwner, limit

2. fetch-coda-tables

   • 从指定的文档中获取所有表格
   • 必需参数：docId

3. fetch-coda-table

   • 从文档中获取特定表格
   • 必需参数：docId, tableId

4. fetch-coda-table-columns

   • 检索特定表格的列信息
   • 必需参数：docId, tableId

5. fetch-coda-rows

   • 从指定的表格中获取行
   • 必需参数：docId, tableId

6. upsert-coda-rows

   • 在表格中插入或更新行
   • 必需参数：docId, tableId, rows

7. delete-coda-rows

   • 从表格中删除指定的行
   • 必需参数：docId, tableId, rowIds

错误处理

服务器实现了全面的错误处理：

• 环境变量验证
• API 响应验证
• 请求参数验证
• 正确的错误消息和日志记录

开发

该项目的结构如下：

src/
├── tools/           # 单个工具实现
│   ├── fetch-coda-docs.tool.ts
│   ├── fetch-coda-tables.tool.ts
│   └── ...
└── index.ts        # 主服务器实现

技术栈

• Express.js - Web 框架
• @modelcontextprotocol/sdk - MCP 实现
• Zod - 运行时类型检查
• dotenv - 环境变量配置

已知限制和未来改进

当前工具的实现需要进行多项改进：

• 增强的 JSON 响应处理和格式化
• 实现大型数据集的分页
• 更好的错误处理和重试机制
• 速率限制实现
• 大型操作的批量处理
• 频繁访问数据的缓存机制
• 还有更多 API 工具需要根据文档实现

MCP 客户端实现示例

以下是如何在 Cursor 中实现此 MCP 服务器的示例：

1. 在 Cursor 的 mcp.json 中配置 MCP 服务器：

2. 在 Cursor 的设置中启用和使用可用的工具：

许可证

该项目根据 ISC 许可证获得许可。