项目简介

Airtable MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务,旨在弥合 AI 工具与 Airtable 之间的鸿沟。它允许支持 MCP 协议的 AI 客户端(如 Cursor、Claude Desktop 等)直接与您的 Airtable 数据进行交互,实现自然语言驱动的数据查询、创建、更新和删除等操作。通过标准化的 MCP 接口,该服务器为 AI 应用提供了安全、可扩展的上下文数据服务,极大地提升了 AI 在数据处理和自动化方面的能力。

主要功能点

  • Airtable 数据集成: 连接 AI 工具与 Airtable,实现数据互联互通。
  • 库 (Base) 管理: 支持列出和选择 Airtable 库 (Base)。
  • 表 (Table) 操作: 允许浏览 Airtable 表 (Table)、字段 (Field) 和记录 (Record)。
  • 数据访问: 提供读取、创建、更新和删除 Airtable 记录的能力。
  • 灵活配置: 支持命令行参数和 Smithery 一键安装,配置简便。
  • 工具化操作: 将 Airtable 操作封装为一系列易于调用的工具,方便 AI 客户端使用。

安装步骤

推荐方式:Smithery 一键安装

  1. 访问 Smithery
  2. 搜索 "@rashidazarang/airtable-mcp"。
  3. 点击 "Install" 并按照 Smithery 的提示完成安装。

备选方式:NPX 快速安装

  1. 确保已安装 Node.js (14+) 和 Python (3.10+)。
  2. 打开终端,运行以下命令全局安装 'airtable-mcp':
    npm install -g airtable-mcp
  3. 或者使用 'npx' 直接运行:
    npx airtable-mcp --token "您的_Airtable_API_令牌" --base "您的_Base_ID"
    请将 '"您的_Airtable_API_令牌"' 替换为您的 Airtable 个人访问令牌,'"您的_Base_ID"' 替换为您的 Airtable Base ID。

手动安装(高级用户)

  1. 克隆 GitHub 仓库到本地:
    git clone https://github.com/rashidazarang/airtable-mcp.git
    cd airtable-mcp
  2. 安装 Python 依赖:
    pip install -r requirements.txt
  3. 运行服务器:
    python3.10 inspector_server.py --token "您的_Airtable_API_令牌" --base "您的_Base_ID"
    同样需要替换令牌和 Base ID。

服务器配置

要将 Airtable MCP Server 集成到您的 MCP 客户端(例如 Cursor),您需要在客户端的 MCP 配置文件中添加服务器信息。以 Cursor 为例,编辑 '~/.cursor/mcp.json' 文件,添加如下配置:

{
  "mcpServers": {
    "airtable-tools": {
      "command": "npx",
      "args": [
        "airtable-mcp",
        "--token", "您的_Airtable_API_令牌",
        "--base", "您的_Base_ID"
      ]
    }
  }
}
  • server name: '"airtable-tools"' - 服务器名称,您可以自定义。
  • command: '"npx"' - 启动服务器的命令,这里使用 'npx' 运行 'airtable-mcp'。
  • args: 启动参数,包括:
    • '"airtable-mcp"': 指定要运行的 npm 包。
    • '"--token", "您的_Airtable_API_令牌"': Airtable 个人访问令牌,请替换为您的真实令牌,用于 API 鉴权。
    • '"--base", "您的_Base_ID"': Airtable Base ID,请替换为您的目标 Base ID,指定默认操作的 Base。

请注意,您需要将 '"您的_Airtable_API_令牌"' 和 '"您的_Base_ID"' 替换为您的实际 Airtable API 令牌和 Base ID。 配置完成后,重启您的 MCP 客户端使配置生效。

基本使用方法

配置并启动 Airtable MCP Server 后,您就可以在 MCP 客户端中使用预定义的工具来操作 Airtable 数据了。例如,在 Cursor 中,您可以:

  1. 列出 Airtable 库 (Base):在编辑器中输入或选择 'list_bases' 工具,即可查看您 Airtable 账户下的所有库。
  2. 列出表 (Table):使用 'list_tables' 工具,可以查看指定库中的所有表。
  3. 查询记录 (Record):使用 'list_records' 工具,输入表名和可选的过滤条件,即可查询表中的记录。
  4. 获取指定记录:使用 'get_record' 工具,输入表名和记录 ID,获取特定记录的详细信息。
  5. 创建记录:使用 'create_records' 工具,输入表名和 JSON 格式的记录数据,即可在表中创建新记录。
  6. 更新记录:使用 'update_records' 工具,输入表名和包含记录 ID 及更新字段的 JSON 数据,更新现有记录。
  7. 设置当前 Base ID: 使用 'set_base_id' 工具,设置后续操作的默认 Airtable Base。

具体工具的使用方法和参数,请参考仓库 'README.md' 文件中 "Available Tools" 部分的详细描述。您可以在 MCP 客户端中通过自然语言指令或工具选择界面来调用这些工具,实现与 Airtable 数据的智能交互。

信息

分类

生产力应用