airtable-mcp-服务器

提供对 Airtable 数据库的读写访问的模型上下文协议 (MLM) 服务器。该服务器使 LLM 能够检查数据库模式，然后读写记录。

https://github.com/user-attachments/assets/c8285e76-d0ed-4018-94c7-20535db6c944

用法

要将此服务器与 Claude Desktop 应用程序一起使用，请将以下配置添加到claude_desktop_config.json的“mcpServers”部分：

将pat123.abc123替换为您的Airtable 个人访问令牌。您的令牌至少应具有schema.bases:read和data.records:read ，以及可选的相应写入权限。

Related MCP server: MCP Server for MySQL

成分

工具

• 列出记录

  • 列出指定 Airtable 表中的记录

  • 输入参数：

    • baseId （字符串，必需）：Airtable 基础的 ID

    • tableId （字符串，必需）：要查询的表的 ID

    • maxRecords （number，可选）：返回的最大记录数。默认为 100。

    • filterByFormula （字符串，可选）：用于过滤记录的 Airtable 公式

• 搜索记录

  • 搜索包含特定文本的记录

  • 输入参数：

    • baseId （字符串，必需）：Airtable 基础的 ID

    • tableId （字符串，必需）：要查询的表的 ID

    • searchTerm （字符串，必需）：在记录中搜索的文本

    • fieldIds （数组，可选）：要搜索的特定字段 ID。如果未提供，则搜索所有基于文本的字段。

    • maxRecords （number，可选）：返回的最大记录数。默认为 100。

• 列表库

  • 列出所有可访问的 Airtable 基地

  • 无需输入参数

  • 返回基础 ID、名称和权限级别

• 列表表

  • 列出特定库中的所有表

  • 输入参数：

    • baseId （字符串，必需）：Airtable 基础的 ID

    • detailLevel (字符串，可选)：获取有关表的详细信息量（ tableIdentifiersOnly 、 identifiersOnly或full ）

  • 返回表 ID、名称、描述、字段和视图（按给定的detailLevel ）

• 描述表

  • 获取特定表的详细信息

  • 输入参数：

    • baseId （字符串，必需）：Airtable 基础的 ID

    • tableId （字符串，必需）：要描述的表的 ID

    • detailLevel (字符串，可选)：获取有关表的详细信息量（ tableIdentifiersOnly 、 identifiersOnly或full ）

  • 返回与 list_tables 相同的格式，但针对单个表

  • 用于获取特定表的详细信息，而无需获取有关基础表中的所有表的信息

• 获取记录

  • 通过 ID 获取特定记录

  • 输入参数：

    • baseId （字符串，必需）：Airtable 基础的 ID

    • tableId （字符串，必需）：表的 ID

    • recordId （字符串，必需）：要检索的记录的 ID

• 创建记录

  • 在表中创建新记录

  • 输入参数：

    • baseId （字符串，必需）：Airtable 基础的 ID

    • tableId （字符串，必需）：表的 ID

    • fields （对象，必需）：新记录的字段和值

• 更新记录

  • 更新表中的一个或多个记录

  • 输入参数：

    • baseId （字符串，必需）：Airtable 基础的 ID

    • tableId （字符串，必需）：表的 ID

    • records （数组，必需）：包含要更新的记录 ID 和字段的对象数组

• 删除记录

  • 从表中删除一个或多个记录

  • 输入参数：

    • baseId （字符串，必需）：Airtable 基础的 ID

    • tableId （字符串，必需）：表的 ID

    • recordIds （数组，必需）：要删除的记录 ID 数组

• 创建表

  • 在基础表中创建新表

  • 输入参数：

    • baseId （字符串，必需）：Airtable 基础的 ID

    • name （字符串，必需）：新表的名称

    • description （字符串，可选）：表的描述

    • fields （数组，必需）：字段定义数组（名称、类型、描述、选项）

• 更新表

  • 更新表的名称或描述

  • 输入参数：

    • baseId （字符串，必需）：Airtable 基础的 ID

    • tableId （字符串，必需）：表的 ID

    • name （字符串，可选）：表的新名称

    • description （字符串，可选）：表的新描述

• 创建字段

  • 在表中创建新字段

  • 输入参数：

    • baseId （字符串，必需）：Airtable 基础的 ID

    • tableId （字符串，必需）：表的 ID

    • name （字符串，必需）：新字段的名称

    • type （字符串，必需）：字段的类型

    • description （字符串，可选）：字段的描述

    • options （对象，可选）：特定于字段的选项

• 更新字段

  • 更新字段的名称或描述

  • 输入参数：

    • baseId （字符串，必需）：Airtable 基础的 ID

    • tableId （字符串，必需）：表的 ID

    • fieldId （字符串，必需）：字段的 ID

    • name （字符串，可选）：字段的新名称

    • description （字符串，可选）：字段的新描述

资源

服务器提供 Airtable 基础和表的架构信息：

• 表模式（ airtable://<baseId>/<tableId>/schema ）

  • 每个表的 JSON 架构信息

  • 包括：

    • 基础ID和表ID

    • 表名称和描述

    • 主字段 ID

    • 字段定义（ID、名称、类型、描述、选项）

    • 查看定义（ID、名称、类型）

  • 从 Airtable 的元数据 API 自动发现

贡献

欢迎在 GitHub 上提交 Pull 请求！开始操作：

1. 安装 Git 和 Node.js

2. 克隆存储库

3. 使用npm install安装依赖项

4. 运行npm run test来运行测试

5. 使用npm run build进行构建

• 编辑src/index.ts后，可以使用npm run build:watch自动构建。这意味着您可以点击保存，重新加载 Claude Desktop（使用 Ctrl/Cmd+R），然后更改就会生效。

发布

版本遵循语义版本规范。

释放：

1. 使用npm version <major | minor | patch>来升级版本

2. 运行git push --follow-tags以使用标签进行推送

3. 等待 GitHub Actions 发布到 NPM 注册表。