SuperAPI AI 工具集

airtable-mcp-server

Airtable MCP 服务器是一个模型上下文协议(Model Context Protocol)服务器,为 AI 系统提供对 Airtable 数据库的读写访问能力。它使 LLM 能够检查数据库架构,并读取、创建、更新、删除记录,以及管理表格、字段和评论。通过标准化的 MCP 接口,AI 客户端(如 Claude Code、Claude Desktop、Cursor、Cline、VS Code 等)可以无缝连接 Airtable 并执行数据操作。该服务器需要配置 Airtable 个人访问令牌,并支持 stdio 和 HTTP 两种传输模式,适用于本地或远程集成场景。

访问官网

工具介绍

Airtable MCP 服务器是一个实现模型上下文协议(Model Context Protocol, MCP)的服务器,旨在让 AI 系统(如大型语言模型)能够与 Airtable 数据库进行交互。它提供了对 Airtable 数据库的读写访问能力,使 LLM 能够检查数据库架构,并读取和写入记录。

主要能力

该服务器提供了一系列工具(Tools),用于操作 Airtable 资源:

记录操作

  • list_records:列出指定 Airtable 表中的记录。支持通过 maxRecords 限制返回数量(默认 100),并可使用 filterByFormula 按公式过滤。
  • search_records:搜索包含特定文本的记录。可指定搜索的字段 ID,支持 maxRecords 限制返回数量。
  • get_record:根据记录 ID 获取特定记录。
  • create_record:在表中创建新记录,需提供字段和值。
  • update_records:更新一个或多个记录,需提供记录 ID 和要更新的字段。
  • delete_records:删除一个或多个记录,需提供记录 ID 数组。

基础(Base)和表(Table)管理

  • list_bases:列出所有可访问的 Airtable 基础,返回基础 ID、名称和权限级别。
  • list_tables:列出特定基础中的所有表。可通过 detailLevel 控制详细程度(tableIdentifiersOnly、identifiersOnly 或 full),返回表 ID、名称、描述、字段和视图。
  • describe_table:获取特定表的详细信息,参数和返回格式与 list_tables 类似,但仅针对单个表。
  • create_table:在基础中创建新表,需提供表名和字段定义数组(包含名称、类型、描述、选项)。
  • update_table:更新表的名称或描述。

字段管理

  • create_field:在表中创建新字段,需提供名称、类型,可选描述和字段特定选项。
  • update_field:更新字段的名称或描述。

评论管理

  • create_comment:在记录上创建评论,需提供文本,可选父评论 ID 用于线程回复。
  • list_comments:列出记录上的评论,支持分页(pageSize 和 offset),返回评论数组及作者、文本、时间戳、反应和提及信息,按从新到旧排序。

使用方式

  1. 安装与配置:遵循 install-mcp 的说明,该工具会为你的 MCP 客户端(如 Claude Code、Claude Desktop、Cursor、Cline、VS Code 等)生成正确的配置。
  2. 获取访问令牌:需要创建一个 Airtable 个人访问令牌。创建时需包含以下作用域:schema.bases:read 和 data.records:read(可选:schema.bases:write、data.records:write、data.recordComments:read、data.recordComments:write),并确保令牌有权限访问目标基础。令牌格式类似 pat123.abc123(实际更长)。将其设置为环境变量 AIRTABLE_API_KEY(替换生成配置中的占位符)。
  3. 运行模式:
    • 默认 stdio 传输:适用于同一机器上的 MCP 客户端,不开放端口。
    • HTTP 模式:用于远程 MCP 客户端。启动后会在 http://localhost:3000/mcp 提供一个无状态 HTTP 服务器。

适用场景

  • 让 AI 助手直接查询、分析和操作 Airtable 中的数据,无需手动导出导入。
  • 自动化数据录入、更新和清理流程。
  • 为 LLM 提供结构化数据访问,增强其回答的准确性和上下文相关性。
  • 在开发环境中集成 Airtable 作为数据后端,通过 AI 进行快速原型设计。

限制与安全注意事项

  • HTTP 传输模式没有内置身份验证,且绑定到 localhost 或私有网络并不能防止浏览器跨域攻击:恶意网站可利用 DNS 重绑定使访问者的浏览器向 http://localhost:3000/mcp 发送请求并调用工具——包括使用该服务器的 Airtable 令牌进行读取、写入和删除记录。
  • 仅应在不受信任的调用者(包括同一机器或网络上的浏览器)无法在未认证的情况下访问 /mcp 的环境中运行 HTTP 模式。实际做法是将其置于需要凭据(如 Authorization 头,浏览器不会跨域附加)的反向代理或网关之后。
  • 如果只想在同一机器上与 MCP 客户端一起使用,应使用默认的 stdio 传输,它不会开放端口。

开发与贡献

欢迎在 GitHub 上提交拉取请求。开发步骤:安装 Git 和 Node.js;克隆仓库;使用 npm install 安装依赖;运行 npm run test 执行测试;使用 npm run build 构建;可使用 npm run build:watch 在编辑 src/index.ts 后自动构建,方便保存后重载 Claude Desktop(Ctrl/Cmd+R)应用更改。版本遵循语义化版本规范,使用 npm version <major | minor | patch> 升级版本,然后 git push --follow-tags。

注意:以上信息基于给定资料,未提供的细节(如具体价格、平台限制等)暂未提供。