coda-mcp

关键词

Coda API文档管理表格操作JSON-RPCAI 助手

使用说明内容（Markdown格式）

  • 项目简介

    • coda-mcp 是一个基于 MCP（Model Context Protocol）的服务器实现，目标是为大模型/LLM 客户端提供对 Coda 文档、表格、行等资源的访问，以及对外部工具的注册与执行能力。服务器通过 JSON-RPC 与客户端通信，内置工具路由以实现对 Coda API 的 CRUD、查询等操作。

  • 主要功能点

    • 提供对 Coda 文档、表、行、页面等资源的读取与修改能力（通过统一的工具接口调用外部 API）。
    • 注册并暴露多种工具（如 list_docs、get_doc、list_tables、add_row 等），供 LLM 调用外部功能。
    • 支持基于 MCP 的服务器信息声明与能力描述（如启用工具能力）。
    • 使用 JSON-RPC 协议接收请求并返回标准的响应，支持初始化与通知等 MCP 流程。
    • 通过 stdio 传输实现简单的本地集成，亦可扩展为其他传输（例如 SSE、WebSocket 等）。
    • 配置化的 API 令牌与 API 基地址，确保对 Coda API 的认证与请求路径可变。

  • 安装步骤

    • 使用发行二进制或源码构建：
      • cargo install coda-mcp（从 crates.io 安装）
      • 或从源码构建：git clone https://github.com/nkpar/coda-mcp.git，cd coda-mcp，cargo build --release
    • 架设后端依赖
      • 需要一个 Coda API Token，配置在 CODA_API_TOKEN 环境变量中；可选 CODA_BASE_URL 用于自定义 API 基地址。

  • 服务器配置（客户端启动 MCP 服务器所需的最小信息，以下为示例描述，实际配置请按需填写）

    • serverName: "coda"
    • command: "coda-mcp" // 运行可执行文件的命令名，通常在 PATH 中可直接访问
    • args: [] // 启动时的参数，如无则留空
    • env（说明性字段，MCP 客户端需要配置环境变量）:
      • CODA_API_TOKEN: "<your_token>"
      • CODA_BASE_URL: "https://coda.io/apis/v1" // 可选，若有自定义请设置
    • 备注
      • CODA_API_TOKEN 为必填，用于对 Coda API 的认证与调用。
      • CODA_BASE_URL 如未设置则使用默认 https://coda.io/apis/v1。
      • MCP 客户端通过上述配置启动服务器进程并与其进行 JSON-RPC 通信。

  • 基本使用方法

    • 启动后，MCP 客户端通过 JSON-RPC 请求与服务器交互，例如初始化后再发送工具调用请求（如 list_docs、get_row 等）。
    • 使用标准的工具参数结构（如 ListDocsParams、GetDocParams 等）来调用对应工具，获得 JSON 格式的响应。
    • 服务器端会对 Coda API 的调用结果进行封装，返回可直接展示给 LLM 的文本与 JSON 数据。
    • 如需扩展或自定义工具，请参考源码中使用 #[tool] 宏定义的新工具实现方式，遵循 MCP 的路由和参数约束。

服务器信息

访问项目