airtable-mcp-server

一个提供 Airtable 数据库读写访问权限的 Model Context Protocol 服务器。该服务器使 LLM 能够检查数据库架构，然后读取和写入记录。

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

安装

第一步：点击此处创建 Airtable 个人访问令牌。详情：

• 名称：任意名称，例如 'Airtable MCP Server Token'。

• 范围：schema.bases:read、data.records:read，以及可选的 schema.bases:write、data.records:write、data.recordComments:read 和 data.recordComments:write。

• 访问权限：您想要访问的库 (bases)。如果不确定，请选择 'Add all resources'。

请妥善保管该令牌，下一步会用到。它看起来应该类似于 pat123.abc123（但更长）。

第二步：按照您首选客户端的说明进行操作：

• Claude Desktop

• Cursor

• Cline

Claude Desktop

(推荐) 通过扩展浏览器

1. 打开 Claude Desktop 并转到 Settings → Extensions

2. 点击 'Browse Extensions' 并找到 'Airtable MCP Server'

3. 点击 'Install' 并粘贴您的 API 密钥

(高级) 替代方案：通过手动 .mcpb 安装

1. 在 GitHub Actions 历史记录 中找到最新的 mcpb 构建版本（最上面的一个）

2. 在 'Artifacts' 部分，下载 airtable-mcp-server-mcpb 文件

3. 将 .zip 文件重命名为 .mcpb

4. 双击 .mcpb 文件以使用 Claude Desktop 打开

5. 点击 "Install" 并使用您的 API 密钥进行配置

(高级) 替代方案：通过 JSON 配置

1. 安装 Node.js

2. 打开 Claude Desktop 并转到 Settings → Developer

3. 点击 "Edit Config" 以打开您的 claude_desktop_config.json 文件

4. 将以下配置添加到 "mcpServers" 部分，并将 pat123.abc123 替换为您的 API 密钥：

{
  "mcpServers": {
    "airtable": {
      "command": "npx",
      "args": [
        "-y",
        "airtable-mcp-server"
      ],
      "env": {
        "AIRTABLE_API_KEY": "pat123.abc123",
      }
    }
  }
}

5. 保存文件并重启 Claude Desktop

Cursor

(推荐) 通过一键安装

1. 点击

2. 编辑您的 mcp.json 文件以插入您的 API 密钥

(高级) 替代方案：通过 JSON 配置

创建全局 (~/.cursor/mcp.json) 或项目特定 (.cursor/mcp.json) 配置文件，并将 pat123.abc123 替换为您的 API 密钥：

{
  "mcpServers": {
    "airtable": {
      "command": "npx",
      "args": ["-y", "airtable-mcp-server"],
      "env": {
        "AIRTABLE_API_KEY": "pat123.abc123"
      }
    }
  }
}

Cline

(推荐) 通过市场安装

1. 点击 Cline 扩展中的 "MCP Servers" 图标

2. 搜索 "Airtable" 并点击 "Install"

3. 按照提示安装服务器

(高级) 替代方案：通过 JSON 配置

1. 点击 Cline 扩展中的 "MCP Servers" 图标

2. 点击 "Installed" 选项卡，然后点击底部的 "Configure MCP Servers" 按钮

3. 将以下配置添加到 "mcpServers" 部分，并将 pat123.abc123 替换为您的 API 密钥：

{
  "mcpServers": {
    "airtable": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "airtable-mcp-server"],
      "env": {
        "AIRTABLE_API_KEY": "pat123.abc123"
      }
    }
  }
}

Related MCP server: MCP TapData Server

组件

工具

• list_records

  • 列出指定 Airtable 表中的记录

  • 输入参数：

    • baseId (字符串，必填)：Airtable 库的 ID

    • tableId (字符串，必填)：要查询的表的 ID

    • maxRecords (数字，可选)：要返回的最大记录数。默认为 100。

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

• search_records

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

  • 输入参数：

    • baseId (字符串，必填)：Airtable 库的 ID

    • tableId (字符串，必填)：要查询的表的 ID

    • searchTerm (字符串，必填)：要在记录中搜索的文本

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

    • maxRecords (数字，可选)：要返回的最大记录数。默认为 100。

• list_bases

  • 列出所有可访问的 Airtable 库

  • 无需输入参数

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

• list_tables

  • 列出特定库中的所有表

  • 输入参数：

    • baseId (字符串，必填)：Airtable 库的 ID

    • detailLevel (字符串，可选)：获取关于表的详细程度 (tableIdentifiersOnly、identifiersOnly 或 full)

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

• describe_table

  • 获取关于特定表的详细信息

  • 输入参数：

    • baseId (字符串，必填)：Airtable 库的 ID

    • tableId (字符串，必填)：要描述的表的 ID

    • detailLevel (字符串，可选)：获取关于表的详细程度 (tableIdentifiersOnly、identifiersOnly 或 full)

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

  • 用于在不获取库中所有表信息的情况下获取特定表的详细信息

• get_record

  • 通过 ID 获取特定记录

  • 输入参数：

    • baseId (字符串，必填)：Airtable 库的 ID

    • tableId (字符串，必填)：表的 ID

    • recordId (字符串，必填)：要检索的记录的 ID

• create_record

  • 在表中创建新记录

  • 输入参数：

    • baseId (字符串，必填)：Airtable 库的 ID

    • tableId (字符串，必填)：表的 ID

    • fields (对象，必填)：新记录的字段和值

• update_records

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

  • 输入参数：

    • baseId (字符串，必填)：Airtable 库的 ID

    • tableId (字符串，必填)：表的 ID

    • records (数组，必填)：包含记录 ID 和要更新字段的对象数组

• delete_records

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

  • 输入参数：

    • baseId (字符串，必填)：Airtable 库的 ID

    • tableId (字符串，必填)：表的 ID

    • recordIds (数组，必填)：要删除的记录 ID 数组

• create_table

  • 在库中创建新表

  • 输入参数：

    • baseId (字符串，必填)：Airtable 库的 ID

    • name (字符串，必填)：新表的名称

    • description (字符串，可选)：表的描述

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

• update_table

  • 更新表的名称或描述

  • 输入参数：

    • baseId (字符串，必填)：Airtable 库的 ID

    • tableId (字符串，必填)：表的 ID

    • name (字符串，可选)：表的新名称

    • description (字符串，可选)：表的新描述

• create_field

  • 在表中创建新字段

  • 输入参数：

    • baseId (字符串，必填)：Airtable 库的 ID

    • tableId (字符串，必填)：表的 ID

    • name (字符串，必填)：新字段的名称

    • type (字符串，必填)：字段类型

    • description (字符串，可选)：字段描述

    • options (对象，可选)：字段特定选项

• update_field

  • 更新字段的名称或描述

  • 输入参数：

    • baseId (字符串，必填)：Airtable 库的 ID

    • tableId (字符串，必填)：表的 ID

    • fieldId (字符串，必填)：字段的 ID

    • name (字符串，可选)：字段的新名称

    • description (字符串，可选)：字段的新描述

• create_comment

  • 在记录上创建评论

  • 输入参数：

    • baseId (字符串，必填)：Airtable 库的 ID

    • tableId (字符串，必填)：表的 ID

    • recordId (字符串，必填)：记录的 ID

    • text (字符串，必填)：评论文本

    • parentCommentId (字符串，可选)：用于线程回复的父评论 ID

  • 返回包含 ID、作者、创建时间和文本的已创建评论

• list_comments

  • 列出记录上的评论

  • 输入参数：

    • baseId (字符串，必填)：Airtable 库的 ID

    • tableId (字符串，必填)：表的 ID

    • recordId (字符串，必填)：记录的 ID

    • pageSize (数字，可选)：要返回的评论数（最大 100，默认 100）

    • offset (字符串，可选)：用于检索额外评论的分页偏移量

  • 返回包含作者、文本、时间戳、反应和提及的评论数组

  • 评论按从新到旧的顺序返回

HTTP 传输

该服务器也可以在 HTTP 模式下运行，以供远程 MCP 客户端使用：

MCP_TRANSPORT=http PORT=3000 npx airtable-mcp-server

这将在 http://localhost:3000/mcp 启动一个无状态 HTTP 服务器。注意：HTTP 传输没有内置身份验证 - 仅在反向代理之后或安全环境中使用。

贡献

欢迎在 GitHub 上提交 Pull Request！开始之前：

1. 安装 Git 和 Node.js

2. 克隆存储库

3. 使用 npm install 安装依赖项

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

5. 使用 npm run build 进行构建

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

发布

版本遵循 语义化版本控制规范。

发布步骤：

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

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

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