Aitable MCP Server

🚀 AITable MCP 服务器

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

✨ 主要特性

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

📦 安装指南

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

• 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}