Airtable MCP Server 是一个面向 AI 应用的 Airtable 集成服务器，通过 Anthropic 的 Model Context Protocol（MCP）把 Airtable 数据接入 AI 客户端，使开发者可以用自然语言完成查询、创建、更新与删除记录，以及管理 base、表和 schema。当前版本为 5.1.0，基于 MCP 2026-07-28 规范，使用 v2 TypeScript SDK（@modelcontextprotocol/server）。
用途与定位 该服务器用于在支持 MCP 的 AI 客户端（如 Claude、Codex、Cursor、Windsurf、VS Code 等）中直接操作 Airtable，覆盖记录读写、结构管理、评论、Webhook、批量处理、治理与 AI 分析等场景。
主要能力
- 完整 CRUD：创建、读取、更新、删除记录，支持过滤与分页。
- 记录评论：列出、创建、更新、删除记录上的评论。
- Schema 管理：以编程方式创建和修改表、字段与视图。
- 批量操作：每次最多处理 10 条记录以提升性能。
- Webhook 管理：为数据变更设置实时通知。
- 治理与合规：允许列表治理、PII 掩盖与异常跟踪。
- 用户身份：通过 whoami 工具验证 token 身份。
- AI 分析：提供 10 个提示模板，用于预测分析、自然语言查询与自动化洞察。
- 多 Base 支持：动态发现并使用多个 base。
- 类型安全：完整的 TypeScript 类型定义。
工具数量 服务器共提供 42 个工具，分为：核心操作（4）、记录 CRUD（5）、Upsert（2）、Schema 发现（4）、表管理（3）、字段管理（3）、批量操作（3）、Webhook 管理（5）、视图与附件（3）、Base 管理（3）、记录评论（4）、用户信息（1）、治理与行政（2）。
协议与传输
- Stateless 核心：每个请求由共享工厂创建的全新服务器实例服务，无会话、无粘性路由；HTTP 模式下任意请求可落到任意副本，适用于无服务器和水平扩展环境。
- 双协议时代：同时服务 2026-07-28 现代客户端（按请求信封）与 2025 时代旧客户端（initialize 握手）；stdio 下按连接固定协议时代，HTTP 下按请求做 stateless 回退。
- 传输方式：stdio（serveStdio）用于本地客户端；设置 PORT 或 MCP_HTTP_PORT 后启用可流式 HTTP（createMcpHandler + Node 适配器），并提供 /health 端点。
- Tasks 扩展：有意未实现；规范已将 Tasks 移出核心，且本服务器所有操作均为亚秒级 Airtable API 调用（批量上限 10 条），后台任务语义无增益。
使用方式
- Claude Desktop：无需安装，在 macOS 的 ~/Library/Application Support/Claude/claude_desktop_config.json 或 Windows 的 %APPDATA%\Claude\claude_desktop_config.json 中加入配置并重启；npx 会自动下载并运行服务器，无需 git clone 或 npm install。
- Claude Code：提供单命令安装脚本，检查前置条件、提示输入 Airtable token，并写入 ~/.claude.json；也可直接传入 token。配置位于 ~/.claude.json 的 mcpServers 下。脚本使用 cd /tmp && 前缀的 bash wrapper，以规避 npx 在含同名 package.json 目录中解析二进制的边界情况。
- Codex：编辑 ~/.codex/config.toml（或受信项目的 .codex/config.toml）；Codex CLI、IDE 扩展与 ChatGPT 桌面应用共享该配置。
- Cursor：加入 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（按项目）。Cursor 对所有服务器的启用工具总数上限为 40，而本服务器暴露 42 个，因此建议设置 AIRTABLE_TOOLSET=core，仅注册 18 个以记录为中心的工具（读、写、批量、治理）；若 Airtable 是唯一 MCP 服务器，可省略或设为 full，并在 Cursor 的 Tools & MCP 设置中按工具禁用。注意 Cursor 仅在 Agent 和 Plan 模式提供 MCP 工具（Ask/Edit 不提供），且消费工具与资源但不消费 MCP prompts。
- Windsurf：将相同 JSON 块加入 ~/.codeium/windsurf/mcp_config.json（Cascade → MCP settings）；支持按工具切换。
- VS Code（GitHub Copilot agent 模式）：加入 .vscode/mcp.json。
- 兼容任意客户端：工具名采用裸 snake_case，长度合规，不含 : 和 *（Cursor 允许列表语法 server:tool 保留字符）；日志一律写入 stderr，不污染 stdout，避免 stdio 帧损坏。
- 远程/HTTP 客户端：设置 PORT 或 MCP_HTTP_PORT 启动服务器，客户端指向 http://host:port/mcp（可流式 HTTP，stateless；/health 供编排器使用）。
- 工具上限控制：使用 AIRTABLE_TOOLSET=core 或显式允许列表（如 AIRTABLE_TOOLSET=describe,query,list_records）以适配限制工具数量的客户端或精简 agent 上下文。
前置条件
- Node.js 20 或更高版本（MCP v2 SDK 要求）。
- 拥有 Airtable 账号及 Personal Access Token，在 airtable.com/create/tokens 创建并授予 Token Scopes 中列出的所有作用域。
- Airtable Base ID（可选；可省略并通过 list_bases 工具动态发现）。Base ID 可在查看 base 时从 URL https://airtable.com/[BASE_ID]/... 获取。
自然语言交互示例
- 基础操作：“列出我可访问的所有 Airtable base”“显示 Projects 表中的所有记录”“创建一个优先级为 High、截止日期为明天的任务”“把任务 ID rec123 的状态更新为 Completed”“搜索 Status 等于 Active 的记录”。
- Schema 管理：“显示此 base 的完整 schema”“创建名为 Tasks 的新表，包含 Name、Priority 与 Due Date 字段”“为 Projects 表添加 Status 字段”。
- 记录评论：“显示 rec123 上的所有评论”“为这条记录添加评论：Reviewed and approved”“把我的评论更新为 Needs revision”。
- 批量操作：“在 Tasks 表中一次创建 5 条新记录”“批量更新多条记录的状态值”“一次操作删除这 3 条记录”。
- Webhook：“列出我 base 中所有活跃 Webhook”“为 Projects 表的变更创建 Webhook”。
环境变量与项目结构 环境变量对普通用户非必需。仅当需要贡献或修改服务器时才克隆仓库；最终用户应使用 npx 方式。
限制与说明
- 批量操作每次最多 10 条记录。
- 当前未实现 2026-07-28 规范中的 Tasks 扩展；若未来加入长时运行工具会重新评估。
- 其他环境变量细节、完整工具参数说明、AI 提示模板具体内容以及治理与合规的详细机制，资料中暂未提供。
许可与支持 项目采用 MIT License，详见 LICENSE。提供 GitHub Discussions 用于交流，并有 Code of conduct 与 Security policy。贡献需先开 issue 讨论重大变更。
