AITable Mcp Server

AITable MCP 服务

一个提供对 AITable.ai 读写权限的模型上下文协议服务。此服务让大模型能够在 AITable.ai 中列出空间、搜索节点、列出记录、创建记录和上传附件。

工具

工具名称	可用	描述
list_spaces	✅	获取当前已认证用户有权访问的所有工作区。
search_nodes	✅	根据指定的类型、权限和查询条件检索节点。
list_records	✅	读取指定数据库中的记录，支持分页、字段筛选和排序选项。
get_fields_schema	✅	返回指定数据库中所有字段的 JSON 架构。
create_record	✅	在数据库中创建新记录。
upload_attachment_via_url	✅	使用附件的网络 URL 将其上传到 AITable 服务。
update_record	❌	TODO

环境变量

• AITABLE_API_KEY：你的 AITable 个人访问令牌。
• AITABLE_BASE_URL：AITable API 的基础 URL。默认为 https://aitable.ai/fusion。如果使用 APITable（AITable 的开源版本），可将其设为 {YOUR_CUSTOM_BASE_URL}。

使用方法

你可以在 MCP 客户端中使用此服务，例如 Claude Desktop、CherryStudio 等。

Claude Desktop 使用 Claude Desktop 时，需要将以下配置信息添加到 claude_desktop_config.json 文件的 "mcpServers" 部分：

Linux、MacOS：

{
  "mcpServers": {
    "aitable": {
      "command": "npx",
      "args": [
        "-y",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/aitable-mcp-server"
      ],
      "env": {
        "AITABLE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Windows：

{
  "mcpServers": {
    "aitable": {
      "command": "npx",
      "args": [
        "-y",
        "D:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\aitable-mcp-server"
      ],
      "env": {
        "AITABLE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

将 YOUR_API_KEY 替换为你的 AITable 个人访问令牌，并将 /ABSOLUTE/PATH/TO/PARENT/FOLDER/aitable-mcp-server 替换为此代码库父文件夹的绝对路径。

CherryStudio 如果你在 Windows 系统上将 CherryStudio 用作 MCP 客户端，配置应如下所示：

{
  "mcpServers": {
    "aitable": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "D:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\aitable-mcp-server"
      ],
      "env": {
        "AITABLE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

调试

MCP inspector 是用于测试和调试 MCP 服务的开发工具。

检查 MCP 服务实现时，无需克隆 MCP inspector 仓库。只需使用 npx 即可。例如，AITable MCP 服务构建于 dist/index.js。参数会直接传递给你的服务，而环境变量可通过 -e 标志设置：

npx @modelcontextprotocol/inspector -e AITABLE_API_KEY={YOUR_API_KEY} node build/index.js

另一种方式是克隆 MCP inspector 仓库，并在 inspector 界面中连接 AITable MCP 服务。

cd path/to/inspector/
npm start -- -e AITABLE_API_KEY={YOUR_API_KEY}