Airtable MCP

Airtable MCP

site icon
2025.03.27 10
Python数据库管理自然语言接口数据操作数据库开发效率
Airtable MCP 是一个连接 AI 工具与 Airtable 的服务,允许用户通过自然语言查询、创建、更新和删除记录。它提供基础管理、表操作、模式操作、记录过滤和数据迁移等功能,兼容 Claude Desktop 和其他 Claude 驱动的编辑器。
View on GitHub

Overview

基本能力

产品定位

Airtable MCP 是一个连接 AI 工具与 Airtable 的服务,允许用户通过自然语言与 Airtable 数据进行交互。

核心功能

  • 基础管理:列出和选择 Airtable 基础
  • 表操作:浏览表、字段和记录
  • 数据访问:读取、创建、更新和删除记录
  • 模式管理:导出、比较和更新模式
  • 自然语言接口:使用纯英语与 Airtable 数据交互

适用场景

  • 需要快速查询和操作 Airtable 数据的场景
  • 希望通过自然语言与数据库交互的场景
  • 需要自动化数据迁移或更新的场景

工具列表

工具名称 描述 示例用法
list_bases 列出所有可访问的 Airtable 基础 "显示我所有的 Airtable 基础"
list_tables 列出当前基础中的所有表 "这个基础中有哪些表?"
list_records 列出记录,可选过滤 "显示 Projects 表中的所有记录"
get_record 获取特定记录 "从 Tasks 表中获取记录 ABC123"
create_records 创建新记录 "在 Contacts 中创建一个名为 John 的新记录"
update_records 更新现有记录 "将记录 XYZ 的状态更新为 Complete"
set_base_id 切换到不同的基础 "切换到基础 appi7fWMQcB3BNzPs"

常见问题解答

  1. 连接问题
  2. 确保 Node.js 已安装(node -v 应显示 v14 或更高版本)
  3. 验证 API 令牌和基础 ID 是否正确
  4. 配置更改后重启 Claude Desktop

  5. JSON 解析错误

  6. 仔细检查配置文件中的 JSON 格式
  7. 避免使用额外的反斜杠或转义字符
  8. 使用上面显示的简化配置格式

  9. 命令未找到

  10. 如果未安装 Node.js,请安装
  11. 运行 npm install -g npm@latest 更新 npm
  12. 尝试运行 npx @smithery/cli --version 以验证安装

使用教程

使用依赖

  • 安装 Node.js(v14 或更高版本) ```bash # 在 macOS 或 Linux 上 curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash nvm install --lts nvm use --lts

# 在 Windows 上(使用 Chocolatey) choco install nodejs ```

安装教程

  1. 获取 Airtable 凭证
  2. 账户页面 获取 Airtable API 令牌
  3. 从 Airtable 基础 URL 获取基础 ID(格式:appi7fWMQcB3BNzPs

  4. 配置 Claude Desktop

  5. 打开 ~/Library/Application Support/Claude/claude_desktop_config.json
  6. 添加以下配置: json { "mcpServers": { "airtable-mcp": { "command": "npx", "args": [ "@smithery/cli", "run", "@rashidazarang/airtable-mcp", "--token", "YOUR_AIRTABLE_TOKEN", "--base", "YOUR_BASE_ID" ] } } }
  7. 替换 YOUR_AIRTABLE_TOKENYOUR_BASE_ID 为实际凭证
  8. 保存并重启 Claude Desktop

  9. 开始使用 Airtable 工具

  10. 打开 Claude Desktop
  11. 等待 30 秒建立连接
  12. 开始使用自然语言命令

调试方式

  • 验证 Node.js 安装 bash node -v
  • 验证 npm 安装 bash npm -v
  • 验证 Smithery CLI 安装 bash npx @smithery/cli --version

许可证

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