JinDaGe - aitable-mcp-server MCP Details

article

README

🚀 AITable MCP 服务器

这是一个模型上下文协议（Model Context Protocol，MCP）服务器，它为 AITable.ai 提供读写访问功能。借助该服务器，大语言模型（LLMs）能够在 AITable.ai 中执行列出空间、搜索节点、列出记录、创建记录以及上传附件等操作。

✨ 主要特性

此服务器具备多种工具，可帮助用户在 AITable.ai 上执行各类操作，具体如下：

| 工具名称 | 是否可用 | 描述 | | ---- | ---- | ---- | | list_spaces | ✅ | 获取当前已认证用户有权限访问的所有工作空间。 | | search_nodes | ✅ | 根据特定类型、权限和查询条件检索节点。 | | list_records | ✅ | 从指定数据库中读取记录，支持分页、字段过滤和排序选项。 | | get_fields_schema | ✅ | 返回指定数据库中所有字段的 JSON 模式。 | | create_record | ✅ | 在数据库中创建新记录。 | | upload_attachment_via_url | ✅ | 使用网络 URL 将附件上传到 AITable 服务器。 | | update_record | ❌ | 待实现 |

📦 安装指南

使用此服务器前，你需要设置以下环境变量：

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 如果你使用 CherryStudio 作为 MCP 客户端，且系统为 Windows，配置应如下所示：

{
  "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 仓库，并在检查器界面中连接 AITable MCP 服务器：

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

aitable-mcp-server