Airtable MCP Server

关键词

Airtable数据集成AI工具数据库自动化

项目简介

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 数据的智能交互。

服务器信息

访问项目