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 ，以及可选的相应写入权限。

成分

工具

• 列出记录
  • 列出指定 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 注册表。