Airtable增强MCP服务器

一个扩展的Airtable MCP服务器,提供CRUD操作、批量导入/更新、数据分析、模式验证和数据导出功能。

  • by tomcwxyz
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 dataforaction-tom/airtable-mcp-server

使用说明

airtable+mcp服务器

用于Claude Code(和其他MCP客户端)的扩展Airtable MCP服务器。提供完整的CRUD以及批量导入/升级、数据分析、根据已知标准进行模式验证和数据导出。

建立在 domdomegg/空中mcp服务器 (MIT许可证)-保留所有原始工具,并添加了6个额外的高级用户工具。

快速开始

1.创建Airtable个人访问令牌

首选 airtable.com/create/tokens 并创建一个具有以下作用域的令牌:

  • schema.bases:read
  • schema.bases:write
  • data.records:read
  • data.records:write
  • data.recordComments:read
  • data.recordComments:write

设置对所需基地的访问权限(或“所有当前和未来基地”)。

2.配置克劳德代码

添加 ~/.claude.json 在...之下 mcpServers:

{
  "mcpServers": {
    "airtable": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/airtable-plus-mcp-server/dist/main.js"],
      "env": {
        "AIRTABLE_API_KEY": "patYOUR_TOKEN_HERE"
      }
    }
  }
}

3.HTTP传输(可选)

对于可重用的HTTP模式:

AIRTABLE_API_KEY=patYOUR_TOKEN MCP_TRANSPORT=http PORT=3000 node dist/main.js

然后将任何MCP客户端指向 http://localhost:3000/mcp.

所有工具(22)

核心阅读(6--来自domdomegg)

工具 说明
list_bases 列出所有可访问的基地
list_tables 在库中列出表(具有详细级别控制)
describe_table 获取特定表格的详细信息
list_records 从表中列出/筛选/排序记录
search_records 跨文本字段的全文搜索
get_record 按ID获取单个记录

核心写作(3--来自domdomegg)

工具 说明
create_record 创建单个记录
update_records 更新一条或多条记录
delete_records 删除一条或多条记录

模式管理(来自domdomdomegg的5--4+1个新)

工具 说明
create_table 使用字段定义创建新表
update_table 更新表名/描述
create_field 向现有表添加字段
update_field 更新字段名称/描述
delete_field 新 --从表中删除字段

评论和附件(3--来自domdomegg)

工具 说明
create_comment 向记录添加注释
list_comments 在记录中列出评论
upload_attachment 将附件上传到记录字段

扩展工具(5--全新)

工具 说明
bulk_import 使用批处理(每组10条)和速率限制导入多达1000条记录。处理每批错误,并可选择在错误时停止。
bulk_upsert 基于合并字段创建或更新记录。分批进行速率限制。非常适合同步来自外部源的数据。
summarise_table 分析表格:记录计数、每个字段的完整性、值分布、数字统计(最小/最大/平均/总和)、唯一值计数。
export_table 将表数据导出为JSON或CSV。支持过滤、字段选择、排序。
validate_schema 根据已知模式验证基础。内置模式: open_referral_uk (HSDS 3.0), simple_crm, project_tracker。还接受JSON格式的自定义模式。

模式验证模式

这 validate_schema 该工具包括三种内置模式:

open_referral.uk --服务目录的Open Referral UK/HDSS 3.0标准。检查组织、服务、位置、联系人、电话、物理地址、常规时间表、资格、分类和服务分类等表及其必填和可选字段。

simple_crm --具有联系人、组织、交互和活动表的基本CRM模式。

项目跟踪器 --使用项目、任务、里程碑和team_members表进行项目管理。

您还可以将自定义模式作为JSON字符串传递:

{
  "name": "My Standard",
  "description": "Custom schema pattern",
  "tables": {
    "people": {
      "requiredFields": ["name", "email"],
      "optionalFields": ["phone", "role"]
    }
  }
}

从源头构建

git clone <this-repo>
cd airtable-plus-mcp-server
npm install
npm run build

致谢

该项目延伸 domdomegg/空中mcp服务器 (MIT许可证)。所有原始工具、类型和架构都得到了保留。扩展工具遵循相同的模式和约定。

许可证

麻省理工学院——见 许可证.