使用说明
airtable+mcp服务器
用于Claude Code(和其他MCP客户端)的扩展Airtable MCP服务器。提供完整的CRUD以及批量导入/升级、数据分析、根据已知标准进行模式验证和数据导出。
建立在 domdomegg/空中mcp服务器 (MIT许可证)-保留所有原始工具,并添加了6个额外的高级用户工具。
快速开始
1.创建Airtable个人访问令牌
首选 airtable.com/create/tokens 并创建一个具有以下作用域的令牌:
schema.bases:readschema.bases:writedata.records:readdata.records:writedata.recordComments:readdata.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许可证)。所有原始工具、类型和架构都得到了保留。扩展工具遵循相同的模式和约定。
许可证
麻省理工学院——见 许可证.
