Airtable MCP Server (airtable-mcp-server)

无线mcp服务器

一个模型上下文协议服务器，提供对Airtable数据库的读写访问。此服务器使LLM能够检查数据库模式，然后读取和写入记录。

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

安装

步骤1: 单击此处创建Airtable个人访问令牌.详细信息：

• 名称：您想要的任何东西，例如“Airtable MCP服务器令牌”。
• 范围： schema.bases:read, data.records:read，并且可选 schema.bases:write, data.records:write, data.recordComments:read，以及 data.recordComments:write.
• 访问：您要访问的基地。如果您不确定，请选择“添加所有资源”。

把代币放在手边，下一步你会需要它的。它应该看起来像 pat123.abc123 （但时间更长）。

步骤2：按照以下说明为您的首选客户进行操作：

• 克劳德桌面版
• 光标
• 克莱恩

克劳德桌面版

（推荐）通过扩展浏览器

1. 打开克劳德桌面并转到设置→ 扩展
2. 单击“浏览扩展”并找到“Airtable MCP服务器”
3. 单击“安装”并粘贴到API密钥中

（高级）替代方案：通过手动.mcpb安装

1. 查找最新的mcpb内置版本 （最上面一个）
2. 在“工件”部分，下载 airtable-mcp-server-mcpb 文件
3. 重命名 .zip 文件到 .mcpb
4. 双击 .mcpb 使用Claude Desktop打开的文件
5. 单击“安装”并使用API密钥进行配置

（高级）替代方案：通过JSON配置

1. 安装
2. 打开克劳德桌面并转到设置→ 开发者
3. 点击“编辑配置”打开您的 claude_desktop_config.json 文件
4. 将以下配置添加到“mcpServers”部分，替换 pat123.abc123 使用API密钥：

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

1. 保存文件并重新启动Claude Desktop

光标

（推荐）一键安装

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"
      }
    }
  }
}

克莱恩

（推荐）通过市场

1. 点击Cline扩展中的“MCP服务器”图标
2. 搜索“Airtable”并单击“安装”
3. 按照提示安装服务器

（高级）替代方案：通过JSON配置

1. 点击Cline扩展中的“MCP服务器”图标
2. 点击“已安装”选项卡，然后点击底部的“配置MCP服务器”按钮
3. 将以下配置添加到“mcpServers”部分，替换 pat123.abc123 使用API密钥：

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

组件

工具

• list_records

- 列出指定Airtable表中的记录 - 输入参数： - baseId （string，必填）：Airtable基座的ID - tableId （string，必填）：要查询的表的ID - maxRecords （number，可选）：要返回的最大记录数。默认值为100。 - filterByFormula （字符串，可选）：用于过滤记录的Airtable公式

• 搜索记录

- 搜索包含特定文本的记录 - 输入参数： - baseId （string，必填）：Airtable基座的ID - tableId （string，必填）：要查询的表的ID - searchTerm （字符串，必填）：要在记录中搜索的文本 - fieldIds （数组，可选）：要搜索的特定字段ID。如果没有提供，则搜索所有基于文本的字段。 - maxRecords （number，可选）：要返回的最大记录数。默认值为100。

• 列表基

- 列出所有可访问的Airtable基地 - 无需输入参数 - 返回基本ID、名称和权限级别

• list_tables

- 列出特定库中的所有表 - 输入参数： - baseId （string，必填）：Airtable基座的ID - detailLevel （string，可选）：要获取的有关表格的详细信息量(tableIdentifiersOnly, identifiersOnly，或 full) - 返回表ID、名称、描述、字段和视图（到给定的 detailLevel)

• describe_table

- 获取特定表的详细信息 - 输入参数： - baseId （string，必填）：Airtable基座的ID - tableId （string，必填）：要描述的表的ID - detailLevel （string，可选）：要获取的关于表格的详细信息量(tableIdentifiersOnly, identifiersOnly，或 full) - 返回与list_tables相同的格式，但针对单个表 - 有助于获取特定表的详细信息，而无需获取基中所有表的信息

• 获取记录

- 按ID获取特定记录 - 输入参数： - baseId （string，必填）：Airtable基座的ID - tableId （string，必填）：表的ID - recordId （string，必填）：要检索的记录的ID

• create_record

- 在表中创建新记录 - 输入参数： - baseId （string，必填）：Airtable基座的ID - tableId （string，必填）：表的ID - fields （object，必填）：新记录的字段和值

• update_records

- 更新表中的一个或多个记录 - 输入参数： - baseId （string，必填）：Airtable基座的ID - tableId （string，必填）：表的ID - records （array，必填）：包含记录ID和要更新的字段的对象数组

• 删除记录

- 从表中删除一条或多条记录 - 输入参数： - baseId （string，必填）：Airtable基座的ID - tableId （string，必填）：表的ID - recordIds （array，必填）：要删除的记录ID数组

• create_table

- 在基中创建新表 - 输入参数： - baseId （string，必填）：Airtable基座的ID - name （string，必填）：新表的名称 - description （字符串，可选）：表的描述 - fields （array，必填）：字段定义数组（名称、类型、描述、选项）

• update_table

- 更新表的名称或描述 - 输入参数： - baseId （string，必填）：Airtable基座的ID - tableId （string，必填）：表的ID - name （字符串，可选）：表的新名称 - description （字符串，可选）：表的新描述

• create_field

- 在表中创建新字段 - 输入参数： - baseId （string，必填）：Airtable基座的ID - tableId （string，必填）：表的ID - name （string，必填）：新字段的名称 - type （string，必填）：字段类型 - description （字符串，可选）：字段描述 - options （对象，可选）：特定于字段的选项

• update_field

- 更新字段的名称或描述 - 输入参数： - baseId （string，必填）：Airtable基座的ID - tableId （string，必填）：表的ID - fieldId （string，必填）：字段的ID - name （字符串，可选）：字段的新名称 - description （字符串，可选）：字段的新描述

• 创建注释

- 在记录上创建注释 - 输入参数： - baseId （string，必填）：Airtable基座的ID - tableId （string，必填）：表的ID - recordId （string，必填）：记录的ID - text （string，必填）：评论文本 - parentCommentId （字符串，可选）：线程回复的父注释ID - 返回创建的注释，包括ID、作者、创建时间和文本

• list_注释

- 列出对记录的评论 - 输入参数： - baseId （string，必填）：Airtable基座的ID - tableId （string，必填）：表的ID - recordId （string，必填）：记录的ID - pageSize （number，可选）：要返回的评论数（最大100，默认100） - offset （字符串，可选）：用于检索其他注释的分页偏移量 - 返回包含作者、文本、时间戳、反应和提及的注释数组 - 评论从最新到最旧返回

HTTP传输

服务器还可以在HTTP模式下运行，以便与远程MCP客户端一起使用：

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

这将在以下位置启动无状态HTTP服务器 http://localhost:3000/mcp注意：HTTP传输没有内置身份验证，只能在反向代理后面或安全环境中使用。

贡献

GitHub上欢迎拉取请求！开始：

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 升级版本
2. 跑 git push --follow-tags 使用标签推送
3. 等待GitHub Actions发布到NPM注册表。