NocoDB MCP 服务器：数据表与记录

💡 无需安装?直接使用 cloud.anythingmcp.com。 登录后点击 Connectors → NocoDB,粘贴你的凭据,生成一个 MCP API 密钥即可。无需 Docker,无需 git clone,无需本地服务器。

NocoDB

从 NocoDB Cloud 或自托管实例读取 NocoDB 的工作区、数据库(base)、数据表和记录。提供 7 个只读工具,基于 v3 REST API,使用 xc-token API 密钥认证。

设置

设置大约需要 2 分钟。你需要准备 NocoDB 的地址和一个 API 令牌。

1. 在 NocoDB 中,打开 Team & Settings → API Tokens 并创建一个令牌。请尽可能使用只读权限的令牌。将它复制到 NOCODB_API_TOKEN。
2. 将 NOCODB_URL 设置为 NocoDB 的根主机地址,末尾不带斜杠:NocoDB Cloud 使用 https://app.nocodb.com,或者使用你自己的主机,例如 https://nocodb.example.com。
3. 安装连接器并运行 nocodb_list_workspaces:它会列出你的令牌可见的工作区。

令牌范围:NocoDB API 令牌作用于整个 NocoDB 实例,并通过 xc-token 请求头发送。若要限制 AI 能看到的内容,请使用仅拥有所需权限的用户账号来创建令牌。

NocoDB 的运行位置:AnythingMCP Cloud 只能访问公网可达的 NocoDB 实例。如果你的 NocoDB 主机位于内网,或解析到私有地址空间,请在同一网络中自托管 AnythingMCP,并通过 SSRF_ALLOWED_HOSTS 放行该主机,否则出站防护会拦截请求。

可读取的内容:通过 NocoDB v3 API,可以读取你的工作区、数据库(base)和数据表,数据表的列(包含名称和类型)、记录、按数字行 ID 获取的单条记录,以及记录数量。ID 之间存在链式关系:nocodb_list_workspaces 返回工作区 ID(以 w 开头),nocodb_list_bases 返回数据库 ID(以 p 开头),nocodb_list_tables 返回数据表 ID。在筛选或排序之前,AI 会调用 nocodb_get_table 获取准确的字段名。筛选使用 NocoDB 语法,例如 (Status,eq,Open)~and(Priority,eq,High),排序使用 JSON,例如 [{"field":"CreatedAt","direction":"desc"}]。

社区版:未获许可的自托管 NocoDB 可能只有一个隐式工作区,因此 nocodb_list_workspaces 可能只返回一个条目或空列表。此时请直接使用已知的工作区 ID 调用 nocodb_list_bases,如果你已经知道数据库 ID,则直接查询数据表。

限制:在 NocoDB Cloud 上,pageSize 会被静默限制为最大 100,自托管实例上为 1000;在翻页读取大表之前,可先用 nocodb_count_records 获取总数。NocoDB 允许每位用户每秒约 5 次请求,该额度由该用户的所有令牌共享。超出后会返回 HTTP 429,并附带 Retry-After 响应头。

该连接器为只读:它不会创建、更新或删除记录、数据表、数据库或工作区,也不使用视图(受套餐限制)、附件、Webhook,以及已弃用的 v1 和 v2 API。

前置条件:NOCODB_URL、NOCODB_API_TOKEN

在本地安装连接器

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

打开 http://localhost:3000/connectors/store,选择 NocoDB,并粘贴前置条件中列出的环境变量。

可用工具

后续步骤

• 连接到 Claude
• 连接到 ChatGPT