Aitable MCP

AITable MCP服务器

AITable

用于与AITable平台集成的模型上下文协议（MCP）服务器。

⚠️ 重要提示： AITable已停产。如果您想迁移到Bika（后续平台），请查看 Bika MCP服务器. AITable LTD持有人： 通过填写以下内容申领您的免费Bika帐户 这种迁移形式 （仅适用于AITable LTD用户）。

概述

此MCP服务器提供与AITable的API的集成，使AI助手能够：

• 查询和筛选数据表记录
• 创建、更新和删除记录
• 上传和管理附件
• 使用字段、视图和节点
• 创建可嵌入链接

特性

• 记录管理：对AITable记录进行完整的CRUD操作
• 现场管理：创建、查询和删除字段
• 视图和节点：访问数据表视图和工作区节点
• 附件：上传和管理文件
• 嵌入链接：创建和管理可嵌入链接
• 配方资源：访问AITable公式文档

先决条件

• Node.js>=18.0.0
• npm或pnpm
• 具有API访问令牌的AITable帐户

安装

选项1：通过npm安装（推荐）

发布后，您可以直接通过npx进行安装：

# No installation needed! Run directly with npx
npx aitable-mcp

选项2：从源代码安装

# Clone the repository
git clone https://github.com/hamchowderr/aitable-mcp.git
cd aitable-mcp

# Install dependencies
npm install

# Build the project
npm run build

配置

环境变量

服务器需要以下环境变量：

设置环境变量

选项1：环境变量

# Windows
set AITABLE_API_TOKEN=your-api-token-here
set SPACE_ID=your-space-id

# macOS/Linux
export AITABLE_API_TOKEN="your-api-token-here"
export SPACE_ID="your-space-id"

选项2：创建 .env 文件

创建一个 .env 项目根目录中的文件：

AITABLE_API_TOKEN=your-api-token-here
SPACE_ID=your-space-id

用法

选项1：克劳德桌面（标准传输）

建议使用此MCP服务器的方式是使用stdio传输的Claude Desktop。

配置文件位置

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 视窗: %APPDATA%\Claude\claude_desktop_config.json

使用npx（推荐）

添加到您的Claude Desktop配置中：

{
  "mcpServers": {
    "aitable": {
      "command": "npx",
      "args": ["-y", "aitable-mcp"],
      "env": {
        "AITABLE_API_TOKEN": "your-token-here",
        "SPACE_ID": "your-space-id"
      }
    }
  }
}

使用本地安装

对于开发或本地安装：

{
  "mcpServers": {
    "aitable": {
      "command": "node",
      "args": ["C:\\absolute\\path\\to\\aitable-mcp\\dist\\stdio-server.js"],
      "env": {
        "AITABLE_API_TOKEN": "your-token-here",
        "SPACE_ID": "your-space-id"
      }
    }
  }
}

重要：更新配置后重新启动Claude Desktop。

选项2：使用MCP检查员进行测试

使用官方MCP检查器在本地测试您的服务器：

# Run the inspector
npm run inspector

# Or run directly
npx @modelcontextprotocol/inspector dist/stdio-server.js

这将：

1. 启动MCP服务器
2. 在以下位置启动检查器web界面 http://localhost:6274
3. 允许您以交互方式测试工具、资源和提示

选项3：独立运行（标准）

直接运行服务器进行stdio传输：

# Build and start
npm run build
npm start

# Development mode with watch
npm run dev

选项4：自定义连接器（通过Vercel进行HTTP传输）

部署为基于HTTP的MCP访问的自定义连接器。

部署到Vercel

1. 初始部署:

   # Install Vercel CLI if needed
   npm install -g vercel

   # Deploy to Vercel
   npx vercel@latest

1. 生产部署:

   npx vercel@latest --prod

1. 设置环境变量:

在Vercel项目设置中（设置→ 环境变量），添加：

- AITABLE_API_TOKEN -您的AITable API令牌（使用AITable进行身份验证所需） - SPACE_ID -您的AITable空间ID（必填）

重要：确保为启用了这两个变量 所有环境 （制作、预览和开发）。如果未选中预览，预览部署URL将失败，并显示“连接被拒绝”。

1. 禁用部署保护（MCP需要）:

在Vercel项目设置中（设置→ 部署保护）：

- 关闭“Vercel身份验证” - 这是Claude Desktop和其他MCP客户端连接所必需的 - 您的数据通过步骤3中配置的API令牌保持安全

1. 在Claude Desktop中配置为自定义连接器:

重要：自定义连接器必须通过Claude Desktop UI配置，而不是通过 claude_desktop_config.json.

要添加自定义连接器，请执行以下操作：

1. 打开克劳德桌面 1. 首选 设置→ 连接器 1. 点击 添加自定义连接器 1. 输入您的部署URL： https://your-project.vercel.app/mcp 1. 保存并重新启动Claude Desktop

备注：确保包括 /mcp 在URL的末尾！

1. 测试部署:

   # Test with the test script
   node scripts/test-streamable-http-client.mjs https://your-project.vercel.app

部署选项

标准与HTTP传输：

• 标准（推荐）：延迟更低，直接进程通信，最适合Claude Desktop
• HTTP（自定义连接器）：集中部署，多客户端，更适合云部署

使用哪一种？

• 使用 标准 用于本地Claude Desktop集成
• 使用 超文本传输协议 适用于集中式部署、多用户或基于云的AI客户端

安全

身份验证概述

此MCP服务器根据传输使用不同的身份验证策略：

标准运输（建议个人使用）

• 使用环境变量进行AITable API身份验证
• 无需客户端身份验证（本地进程，无网络暴露）
• 个人使用最安全
• 通过配置 claude_desktop_config.json

HTTP传输（自定义连接器）

• 作为无服务器功能部署到Vercel
• 需要禁用Vercel部署保护
• CORS已启用，支持基于浏览器的访问
• 安全存储在Vercel中的环境变量

安全最佳实践

重要：

• ⚠️ 保持你的 AITABLE_API_TOKEN secret-它授予对AITable数据的完全访问权限
• ⚠️ 保持部署URL私有-仅与受信任的用户共享
• ⚠️ 禁用Vercel部署保护 供MCP客户端连接
• ✅ 在Vercel中使用环境变量（永远不要将令牌提交给git）
• ✅ 定期旋转您的API令牌
• ✅ 监控Vercel仪表板中的访问日志
• ✅ 对于个人使用，更喜欢stdio传输而不是HTTP

建筑

此MCP服务器支持 双重运输 遵循官方MCP模式：

标准传输（src/Stdio-server.ts）

• Claude Desktop的主要入口点
• 通过stdin/stdout直接进行进程通信
• 低延迟，非常适合本地开发
• 可通过以下方式执行 npx 或 node dist/stdio-server.js

HTTP传输（api/server.ts）

• 支持CORS的Vercel无服务器功能
• 用途 mcp-handler HTTP传输库
• 支持自定义连接器部署
• 所有请求都在根路径上处理，并采用包罗万象的路由

这两种传输共享相同的核心业务逻辑，同时提供不同的通信机制。

项目结构

aitable-mcp/
├── src/
│   ├── stdio-server.ts    # Stdio entry point
│   ├── http-server.ts     # Local HTTP server for testing
│   ├── aitable-tools.ts   # MCP tool implementations
│   ├── formula-resource.ts # Formula documentation provider
│   ├── types.ts           # TypeScript type definitions
│   └── *.md               # Formula documentation files
├── api/
│   └── server.ts          # HTTP entry point (Vercel)
├── public/
│   └── index.html         # Landing page
├── scripts/
│   ├── test-client.mjs                    # SSE transport tester
│   └── test-streamable-http-client.mjs    # HTTP transport tester
├── dist/                  # Compiled output
├── package.json
├── tsconfig.json
├── vercel.json            # Vercel configuration
└── README.md

可用工具（16）

MCP服务器提供全面的AITable集成工具：

记录管理

• get_records -通过过滤、排序和分页查询记录
• create_records -创建新记录（每个请求最多10条）
• update_records -更新现有记录（每次请求最多10条）
• delete_records -删除记录（每次请求最多10条）

现场管理

• get_fields -从数据表中获取字段元数据
• create_field -在数据表中创建新字段
• delete_field -从数据表中删除字段

视图和数据表

• get_views -从数据表中获取视图
• create_datasheet -使用自定义字段创建新的数据表

附件

• upload_attachment -将文件上传到数据表

节点和工作区

• get_node_list -获取工作区中的文件列表
• search_nodes -按类型、权限和关键字搜索节点
• get_node_detail -获取特定节点的详细信息

嵌入链接

• create_embed_link -为节点创建可嵌入的链接
• get_embed_links -列出节点的所有嵌入链接
• delete_embed_link -删除/禁用嵌入链接

可用资源（8）

公式参考文件：

• formula_overview -AITable公式快速参考指南
• formula_operators -AITable公式运算符
• formula_numeric -A表中的数字函数
• formula_string -AITable字符串函数
• formula_logical -A表逻辑功能
• formula_date -A日期/时间函数
• formula_array -AITable数组函数
• field_colors -AITable字段颜色参考

发展

# Clean build artifacts
npm run clean

# Build TypeScript
npm run build

# Watch mode for development
npm run dev

# Test HTTP server locally
npm run dev:http

# Test with Vercel dev server
npm run dev:vercel

贡献

欢迎投稿！请确保您的更改保持双传输架构。

用于人工智能辅助开发

如果你正在使用Claude Code或其他人工智能助手来处理这个代码库，请运行 /init 生成a CLAUDE.md 包含特定于此项目的架构指导和开发模式的文件。

许可证

麻省理工学院

相关项目

Bika MCP服务器

AITable已停产。对于后续平台，请查看 Bika MCP服务器。它为Bika.ai提供了类似的MCP集成，使您的工作流程易于迁移。

资源

• A表格
• Bika.ai -AITable后继平台
• 模型上下文协议
• TypeScript SDK
• Bika MCP服务器 -用于Bika.ai集成的MCP服务器