Coda MCP只读服务器

该项目实现了一个模型上下文协议(MCP)服务器,作为与Coda API交互的桥梁,允许MCP客户端(如AI助手)在Coda页面上执行如列出和读取等操作。

  • by arco-greendigit
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 arco-greendigit/coda-mcp-readonly

使用说明

Coda MCP只读服务器

该项目实现了一个模型上下文协议(MCP)服务器,该服务器充当与 尾声 API它允许MCP客户端(如AI助手)在Coda页面上执行操作,如列表和阅读。

致谢

这个项目是原始项目的一个分支 Coda MCP服务器.

把归 老鹰 Lazri 为该工具的原始实现和基础。

特性

服务器向MCP客户端公开以下工具:

  • coda_list_documents:列出用户可用的所有文档。
  • coda_list_pages:列出配置的Coda文档中支持分页的所有页面。
  • coda_get_page_content:以markdown的形式检索指定页面的内容(按ID或名称)。
  • coda_peek_page:查看页面的开头并返回有限数量的行。
  • coda_resolve_link:解析给定Coda对象的浏览器链接的元数据。
  • coda_list_tables:列出文档中的表。
  • coda_list_columns:列出表中的列。
  • coda_list_rows:列出表中具有可选筛选和排序的行。
  • coda_get_row:从表中获取一行。

用法

将MCP服务器添加到Cursor/Claude Desktop等,如下所示:

{
  "mcpServers": {
    "coda-readonly": {
      "command": "npx",
      "args": ["-y", "coda-mcp-readonly@latest"],
      "env": {
        "API_KEY": "..."
      }
    }
  }
}

所需的环境变量:

  • API_KEY:您的Coda API密钥。您可以从Coda帐户设置中生成一个。

本地设置

  1. 先决条件:

    • Node.js
    • pnpm
  2. 克隆存储库:

    git clone <repository-url>
    cd coda-mcp
    
  3. 安装依赖项:

    pnpm install
    
  4. 构建项目:

    pnpm build
    

    这将TypeScript代码编译为JavaScript dist/ 目录。

运行服务器

MCP服务器通过标准输入/输出(stdio)进行通信。要运行它,请设置环境变量并运行编译后的JavaScript文件- dist/index.js.