Nocodb MCP 服务器

简介

NocoDB MCP 服务器通过模型上下文协议（MCP）实现了与您的 NocoDB 数据库的无缝交互。此服务器使您能够使用自然语言命令轻松地对 NocoDB 表执行 CRUD（创建、读取、更新、删除）操作。

示例提示

[获取记录]
从 nocodb 获取数据，表：Shinobi

[创建记录]
添加新行，名称：sasuke-2
添加其他行，名称：naruto-2

[更新记录]
更新所有行，移除后缀 -

[删除记录]
删除所有名称为 naruto 的行

[添加列]
添加名为 Age 的列

更新所有行，设置 Age 为 18

[删除列]
删除名为 Age 的列

示例提示 - 上传文件

[创建表]
从 JSON 文件
放入 nocodb 数据库
表名是 TableShinobi

JSON 文件位置在：example_upload.json

示例提示 - 批量创建记录和批量删除记录

关于这个分支

此仓库是一个基于 TypeScript 的 NocoDB-MCP-Server 分支。它保留了核心功能，同时提高了可维护性和与现代 TypeScript 开发实践的兼容性。

设置

确保已安装 Node.js 和 TypeScript，然后执行：

npm install
npm run build

配置

在 .env 文件中定义所需的环境变量：

NOCODB_URL=https://your-nocodb-instance.com
NOCODB_API_TOKEN=your_api_token_here
NOCODB_BASE_ID=your_base_id_here

提示： 您可以从 env.example 复制模板并填写您的值。

如何获得 NOCODB_BASE_ID

要找到您的 NOCODB_BASE_ID，请检查您的 Nocodb 实例的 URL。
例如： https://app.nocodb.com/#/wi6evls6/pqmob3ammcknma5/maty9c5xkmf4012
在此 URL 格式中：

https://app.nocodb.com/#/{用户名}/{NOCODB_BASE_ID}/{表ID}

与 Claude Desktop 集成

修改 claude_desktop_config.json 以包含：

{
  "mcpServers": {
    "nocodb": {
      "command": "node",
      "args": ["{工作目录}/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"
      }
    }
  }
}

直接从 CLI 调用

您可以直接从命令行调用 MCP 服务器：
NOCODB_URL、NOCODB_API_TOKEN 和 NOCODB_BASE_ID 是必需参数。
如果您使用的是 NocoDB 云，则 NOCODB_URL=https://app.nocodb.com。

npx -y nocodb-mcp-server {NOCODB_URL} {NOCODB_BASE_ID} {NOCODB_API_TOKEN} 

测试 CLI

要运行测试，请执行：

npx -y @wong2/mcp-cli npx nocodb-mcp-server {NOCODB_URL} {NOCODB_BASE_ID} {NOCODB_API_TOKEN} 

API 函数

有关可用 API 函数的详细信息，请参阅 API_FUNCTION.md。

项目结构

/项目根目录
  ├── src/            # TypeScript 源文件
  ├── dist/           # 编译后的 JavaScript 输出
  ├── .env            # 环境变量配置
  ├── package.json    # 项目依赖项和脚本
  ├── tsconfig.json   # TypeScript 设置

贡献指南

鼓励贡献！请随意打开问题或提交拉取请求。

许可证

此项目根据 MIT 许可证分发。