适合谁
- 希望使用自然语言与 NocoDB 交互的开发者。
- 需要快速在 NocoDB 中执行 CRUD 操作的用户。
- 熟悉 MCP 协议并希望集成到 AI 助手的场景。
N
43FMRS · D
该服务器提供了将 NocoDB 与 MCP 集成的简洁实现，支持 CRUD 和批量操作，但作为社区分支，其稳定性和安全性需用户自行评估。
NocoDB MCP 服务器允许通过自然语言命令对 NocoDB 表执行 CRUD 操作，如创建、读取、更新和删除记录，还支持添加或删除列、批量操作以及从 JSON 文件创建表格。它基于 TypeScript 开发，是 granthooks/Nocodb-MCP-Server 的一个分支，旨在提高可维护性和与现代 TypeScript 实践的兼容性。
工具能力
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 表中的记录。
create_table_from_json
根据 JSON 数据在 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"
}
}
}
}
选型与风险
不适合谁
- 不适用于非 NocoDB 数据库。
- 不适合需要复杂事务或高级查询的场景。
- 不适用于对安全性要求极高的生产环境，因为该分支未经官方维护。
所需权限
- 需要 NocoDB 实例的 URL、API Token 和 Base ID。
- 该服务器使用 NocoDB API，需要相应的读写权限。
风险与副作用
- API 令牌可能会被暴露，需妥善保管。
- 该服务器是第三方分支，可能未经过严格安全审计。
- 误操作可能导致数据永久删除或覆盖。
常见排障
- 常见问题包括环境变量配置错误、NocoDB URL 不可达、API Token 无效等。
- 检查 .env 文件中的值是否正确，并确保 NocoDB 实例可访问。
使用场景
通过自然语言查询和操作 NocoDB 中的数据。
自动化数据录入，例如从 JSON 文件创建表。
批量更新或删除记录，简化数据维护。
支持客户端
Claude Desktop完整支持