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