Airtable集成服务

Airtable MCP Server是一个用于与ChatGPT Apps SDK集成的服务,提供完整的OAuth 2.0认证流程和30多种Airtable工具,包括CRUD操作、批量操作、视图管理等。

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

使用说明

Airtable MCP服务器

用于Airtable与ChatGPT Apps SDK集成的模型上下文协议服务器。

特性

  • 使用Airtable的完整OAuth 2.0身份验证流程
  • 30+Airtable工具(CRUD、模式、批量操作、视图、附件、注释)
  • 5个UI小部件使用 @openai/apps-sdk-ui:
    • 列出记录
    • 创建记录
    • 更新记录
    • 获取记录
    • 创建评论
  • 基于SSE的MCP协议通信
  • Docker+Railway部署就绪

先决条件

  • Node.js 18+
  • Airtable OAuth应用程序凭据
  • 已配置环境变量

安装

npm install

环境变量

AIRTABLE_CLIENT_ID=your_client_id
AIRTABLE_CLIENT_SECRET=your_client_secret
AIRTABLE_REDIRECT_URI=http://localhost:8006/auth/callback
PORT=8006

发展

# Run development server
npm run dev

# Build server and widgets
npm run build

# Build server only
npm run build:server

# Build widgets only
npm run build:widgets

部署

服务器已配置为使用Docker进行Railway部署。在铁路项目中设置环境变量。

设计理念

此MCP服务器遵循Airtable的心理模型 三层:

  1. UI是一个投影 -视图显示数据,但代理不操纵UI状态
  2. 视图是透镜 -代理通过视图进行查询,但不修改视图定义
  3. 代理人会改变数据;人类操纵演示文稿 -明确区分关注点

UI小部件原理

  • list_records -记录的只读网格式投影。代理可以查询和查看,但UI状态(过滤器、排序)是人为控制的。
  • get_record -记录详细信息面板,显示所有字段、附件和元数据。代理可以读取并触发更新。
  • create_record / update_record -数据突变形式。代理直接写入数据。
  • create_comment -评论面板作为 共享切换界面 在代理人和人类之间。这是代理沟通状态、问题和上下文的地方。

关键原则: 让代理编写数据,让人类策划视图。评论是协作的桥梁。

工具

模式和发现

  • list_bases -获取所有可访问的基地
  • get_base_schema -包含表/字段的完整架构
  • list_tables -基座中的桌子
  • list_fields -表中的字段
  • list_views -表的视图

记录操作

  • list_records -使用过滤器/排序/分页进行查询⭐ 有UI
  • get_record -按ID列出的单个记录⭐ 有UI
  • create_record -插入新记录⭐ 有UI
  • update_record -部分更新(PATCH)⭐ 有UI
  • replace_record -完全替换(PUT)
  • delete_record -按ID删除

批量操作

  • batch_create_records -创建多条记录
  • batch_update_records -更新多条记录
  • batch_delete_records -删除多条记录

查询和视图

  • query_records -使用公式进行高级过滤
  • get_view_records -记录作为视图定义它们

附件

  • upload_attachment -将文件上传到附件字段
  • list_attachments -从记录中获取附件

评论

  • get_comments -检索记录注释
  • create_comment -在记录中发表评论⭐ 有UI

复合工具

  • upsert_record -基于唯一密钥创建或更新
  • validate_schema_compatibility -检查字段类型兼容性

许可证

麻省理工学院


由ZeroTwo提供技术支持

此MCP服务器是 ZeroTwo人工智能平台 --一个统一的工作空间,将GPT-5、Claude、Gemini、图像生成、人工智能搜索和像这样的强大集成整合到一个订阅中。

🌐 ZeroTwo——一个应用程序中的所有AI模型 面向高级用户的最佳AI平台。无需切换应用程序即可访问GPT-5、Claude和Gemini。
✨ 零两个功能 AI聊天、图像工作室、视频生成、文档工具和MCP驱动的集成。
🤖 人工智能模型——GPT-5、克劳德和双子座 并排比较和使用世界顶级AI模型。
🔌 ZeroTwo连接器和集成 将Airtable、Gmail、Google Drive、Slack等直接连接到您的AI工作流程。
💰 零二定价 一个替代ChatGPT Plus、Claude Pro和Gemini Advanced的订阅。
📝 ZeroTwo博客 ZeroTwo团队的AI新闻、教程和更新。
🚀 免费试用ZeroTwo 开始使用当今最完整的人工智能平台。

专为ZeroTwo打造 --使用此Airtable MCP服务器 ZeroTwo的AI连接器系统 直接从您的AI聊天界面管理您的Airtable基地。