← 返回目录

NocoDB MCP Server

社区

通过自然语言与 NocoDB 数据库交互的 MCP 服务器。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 数据库第 53 / 58
Stars: ★ 76 热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 需要 API Key / 凭据
最近提交: 6 个月前 ⚠
工具数: 9

43FMRS · D

该服务器提供了将 NocoDB 与 MCP 集成的简洁实现，支持 CRUD 和批量操作，但作为社区分支，其稳定性和安全性需用户自行评估。

最强项 · 安装易用性 12/20 最弱项 · 可靠性 6/20

可靠性

6/20

安全与权限

8/20

维护活跃度

8/20

文档质量

9/20

安装易用性

12/20

查看各项评分依据

可靠性 6/20: 代码库包含 TypeScript 源文件和构建脚本，但未发现 CI 工作流或测试套件。工具列表和错误处理逻辑无法静态验证，因此可靠性评分上限为 6。
安全与权限 8/20: 凭据通过环境变量传递，未在代码中发现硬编码的秘密。工具执行 CRUD 操作，但没有显式的破坏性操作确认机制。网络请求限于配置的 NocoDB 实例。
维护活跃度 8/20: 仓库最近有提交，有一个开放问题，但未发现许可证文件。维护活跃，但缺乏正式的治理和版本发布策略。
文档质量 9/20: README 提供了清晰的安装、配置和客户端集成示例，并链接到 API 函数文档。但缺少故障排除和限制说明。
安装易用性 12/20: 安装步骤简单，有明确的构建和配置指导，并提供了客户端配置示例。但未提供 CI 或测试，且依赖手动构建步骤。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络连接数据库

适合谁

希望使用自然语言与 NocoDB 交互的开发者。
需要快速在 NocoDB 中执行 CRUD 操作的用户。
熟悉 MCP 协议并希望集成到 AI 助手的场景。

不适合谁

不适用于非 NocoDB 数据库。
不适合需要复杂事务或高级查询的场景。
不适用于对安全性要求极高的生产环境，因为该分支未经官方维护。

所需权限

需要 NocoDB 实例的 URL、API Token 和 Base ID。
该服务器使用 NocoDB API，需要相应的读写权限。

风险与副作用

API 令牌可能会被暴露，需妥善保管。
该服务器是第三方分支，可能未经过严格安全审计。
误操作可能导致数据永久删除或覆盖。

安装接入

准备工作

运行环境：Node.js

NOCODB_URL 必填你的 NocoDB 实例地址，使用 NocoDB 云时设为 https://app.nocodb.com。

NOCODB_BASE_ID 必填 NocoDB 的 base ID，可从实例 URL 的路径段中获取（https://app.nocodb.com/#/{用户名}/{NOCODB_BASE_ID}/{TABLE_ID}）。

NOCODB_API_TOKEN 必填密钥 NocoDB API 令牌，需在 NocoDB 中生成，属敏感凭据。

确保已安装 Node.js 和 TypeScript，然后在项目根目录运行 npm install 和 npm run build。配置 .env 文件，设置 NOCODB_URL、NOCODB_API_TOKEN 和 NOCODB_BASE_ID。对于 Claude Desktop，编辑 claude_desktop_config.json 添加 mcpServers 配置。

claude_desktop_config.json

{
  "mcpServers": {
    "nocodb": {
      "command": "node",
      "args": [
        "{working_folder}/dist/start.js"
      ],
      "env": {
        "NOCODB_URL": "https://your-nocodb-instance.com",
        "NOCODB_BASE_ID": "your_base_id_here",
        "NOCODB_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "nocodb": {
      "command": "node",
      "args": [
        "{working_folder}/dist/start.js"
      ],
      "env": {
        "NOCODB_URL": "https://your-nocodb-instance.com",
        "NOCODB_BASE_ID": "your_base_id_here",
        "NOCODB_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add nocodb -e NOCODB_URL=https://your-nocodb-instance.com -e NOCODB_BASE_ID=your_base_id_here -e NOCODB_API_TOKEN=your_api_token_here -- node '{working_folder}/dist/start.js'

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

启动后在 MCP 客户端工具列表中确认出现 get_records、create_record 等工具，然后运行一个自然语言提示（如"从 nocodb 获取数据，表：Shinobi"）验证能否成功读取记录。

常见排障

常见问题包括环境变量配置错误、NocoDB URL 不可达、API Token 无效等。
检查 .env 文件中的值是否正确，并确保 NocoDB 实例可访问。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

从 nocodb 获取数据，表：Shinobi
新增一行，name 为 sasuke-2
更新所有行，去掉 name 中的 - 后缀
删除 name 为 naruto 的所有行

工具能力 9

get_records 只读

从 NocoDB 表中获取记录。

create_record 写入

在 NocoDB 表中创建新记录。

update_record 写入

更新 NocoDB 表中的现有记录。

delete_record 破坏性

删除 NocoDB 表中的记录。

add_column 写入

向 NocoDB 表添加新列。

delete_column 破坏性

从 NocoDB 表中删除列。

bulk_create_records 写入

批量创建 NocoDB 表中的记录。

bulk_delete_records 破坏性

批量删除 NocoDB 表中的记录。

展开其余 1 个工具

create_table_from_json

根据 JSON 数据在 NocoDB 中创建新表。

使用场景

通过自然语言查询和操作 NocoDB 中的数据。

自动化数据录入，例如从 JSON 文件创建表。

批量更新或删除记录，简化数据维护。

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

NocoDB MCP 服务器允许通过自然语言命令对 NocoDB 表执行 CRUD 操作，如创建、读取、更新和删除记录，还支持添加或删除列、批量操作以及从 JSON 文件创建表格。它基于 TypeScript 开发，是 granthooks/Nocodb-MCP-Server 的一个分支，旨在提高可维护性和与现代 TypeScript 实践的兼容性。