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

关于此 Fork

此存储库是 Nocodb-MCP-Server 的基于 TypeScript 的 fork。它 保留了核心功能，同时提高了可维护性以及与现代 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/#/{USERNAME}/{NOCODB_BASE_ID}/{TABLE_ID}

与 Claude Desktop 集成

修改 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"
      }
    }
  }
}

从 CLI 直接调用

您可以从命令行直接调用 MCP 服务器： NOCODB_URL、NOCOBD_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_FUNCTION.md 获取 API 函数

项目结构

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

贡献指南

欢迎贡献！ 随时提出问题或提交拉取请求。

许可证

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