Airtable MCP

Airtable MCP

site icon
2025.03.15 1
Airtable 集成数据管理AI 工具集成开发效率数据库
Airtable MCP 是一个强大的 Airtable 集成工具,通过 Anthropic 的 Model Context Protocol (MCP) 使 AI 驱动的应用程序能够直接从 IDE 访问和操作 Airtable 数据。它支持自然语言查询、创建、更新和删除记录,以及管理基础、表和记录等操作。
View on GitHub

Overview

基本能力

产品定位

Airtable MCP 是一个连接 AI 工具和 Airtable 的中间件,通过 MCP 协议使 AI 客户端能够直接操作 Airtable 数据。

核心功能

  • 基础管理:列出和选择 Airtable 基础
  • 表操作:浏览表、字段和记录
  • 数据访问:读取、创建、更新和删除记录
  • 模式管理:导出、比较和更新模式
  • 命令行配置:通过命令行参数直接使用 API 令牌
  • NPX 兼容:通过单个命令轻松安装
  • Smithery 集成:通过 Smithery 一键安装

适用场景

  • 在 IDE 中直接操作 Airtable 数据
  • 通过自然语言查询 Airtable 数据
  • 自动化数据迁移和模式更新
  • 与 AI 编辑器集成,如 Cursor、Claude Desktop 等

工具列表

工具名称 描述
list_bases 列出所有可访问的 Airtable 基础
list_tables 列出指定或默认基础中的所有表
list_records 从表中列出记录,可选过滤
get_record 从表中获取特定记录
create_records 从 JSON 字符串在表中创建记录
update_records 从 JSON 字符串更新表中的记录
delete_records 按 ID 从表中删除记录
export_records 将表中的记录导出为 JSON 字符串
import_records 从 JSON 字符串将记录导入到表中
create_tables 从 JSON 模式创建表
update_schema 更新现有表以匹配 JSON 模式
set_base_id 设置当前 Airtable 基础 ID
inspect_table 获取表结构和字段的详细信息
export_schema 以 JSON 或 CSV 格式导出当前基础的架构
compare_schemas 比较提供的架构与当前基础架构
generate_field_mapping 生成两个表之间的字段映射
migrate_data 使用指定的字段映射将数据从一个表迁移到另一个表

常见问题解答

  • 如何安装? 推荐使用 Smithery 一键安装,或通过 NPX 快速启动。
  • 需要哪些前置条件? Node.js 14+、Python 3.10+、Airtable API 令牌和兼容的 MCP 客户端。
  • 如何配置 MCP 客户端? 更新 ~/.cursor/mcp.json 文件并重启客户端。

使用教程

使用依赖

  • Node.js 14+
  • Python 3.10+
  • Airtable API 令牌
  • 兼容的 MCP 客户端(如 Cursor、Claude Desktop 等)

安装教程

Smithery 安装(推荐)

  1. 访问 Smithery
  2. 搜索 "@rashidazarang/airtable-mcp"
  3. 点击 "Install" 并按照提示操作

使用 NPX 快速启动

# 全局安装
npm install -g airtable-mcp

# 或直接使用 npx 运行
npx airtable-mcp --token "your_airtable_token" --base "your_base_id"

手动安装(高级)

  1. 克隆仓库: bash git clone https://github.com/rashidazarang/airtable-mcp.git cd airtable-mcp
  2. 安装依赖: bash pip install -r requirements.txt
  3. 运行服务器: bash python airtable_mcp/src/server.py --token "your_airtable_token" --base "your_base_id"

调试方式

  1. 配置 MCP 客户端(如 Cursor): json { "mcpServers": { "airtable-tools": { "command": "npx", "args": [ "airtable-mcp", "--token", "your_airtable_token", "--base", "your_base_id" ] } } }
  2. 重启 MCP 客户端以加载新工具
  3. 使用自然语言命令测试功能,如:
  4. "Show me all the bases I have access to"
  5. "List the tables in my current base"
  6. "Get the first 10 records from the Orders table"

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。