MCP 服务器

Airtable MCP

使 AI 驱动的应用程序能够直接从您的 IDE 访问和操作 Airtable 数据，支持通过自然语言命令进行查询、创建、更新和删除记录等操作。

README

Airtable MCP

将你的 AI 工具直接连接到 Airtable。使用自然语言查询、创建、更新和删除记录。功能包括数据库管理、表格操作、模式操作、记录过滤和数据迁移——所有这些都通过一个标准化的 MCP 接口，该接口与 Cursor、Claude Code、Cline、Zed 和其他 Claude 驱动的编辑器兼容。

此应用程序是一个强大的 Airtable 集成工具，它使 AI 驱动的应用程序能够通过 Anthropic 的模型上下文协议 (MCP) 直接从你的 IDE 访问和操作 Airtable 数据。

功能

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

架构

有两个核心组件用于访问和操作 Airtable 数据：

Airtable MCP 服务器: 一个 Python 服务器，提供标准化的工具，供 AI 客户端与 Airtable 交互。
MCP 客户端: 任何支持模型上下文协议的客户端（Cursor、Claude Desktop、Cline、Zed 等）。

┌─────────────┐     ┌──────────────┐     ┌───────────────┐
│  MCP 客户端 │ ──► │  Airtable    │ ──► │   Airtable    │
│  (例如      │ ◄── │  MCP 服务器  │ ◄── │     API       │
│   Cursor)   │     │              │     │               │
└─────────────┘     └──────────────┘     └───────────────┘

模型上下文协议 (MCP) 是 Anthropic AI 模型支持的一项功能，允许你为任何兼容的客户端创建自定义工具。像 Claude Desktop、Cursor、Cline 或 Zed 这样的 MCP 客户端可以运行一个 MCP 服务器，该服务器“教导”这些客户端关于它们可以使用的新工具。

安装

前提条件

Node.js 14+
Python 3.10+（自动检测）
Airtable API 令牌
兼容的 MCP 客户端（Cursor、Claude Desktop 等）

Smithery 安装（推荐）

最简单的安装方式：

访问 Smithery
搜索 "@rashidazarang/airtable-mcp"
点击“安装”并按照提示操作

使用 NPX 快速设置（替代方案）

另一种快速入门的方法：

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

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

配置你的 MCP 客户端

对于 Cursor，更新你的 ~/.cursor/mcp.json 文件：

{
  "mcpServers": {
    "airtable-tools": {
      "command": "npx",
      "args": [
        "airtable-mcp",
        "--token", "your_airtable_token",
        "--base", "your_base_id"
      ]
    }
  }
}

重启你的 MCP 客户端以加载新工具。

手动安装（高级）

如果你更喜欢克隆存储库并手动安装：

克隆此存储库：

git clone https://github.com/rashidazarang/airtable-mcp.git
cd airtable-mcp

安装依赖项：
```
pip install -r requirements.txt
```

运行服务器：

python airtable_mcp/src/server.py --token "your_airtable_token" --base "your_base_id"

用法

安装和配置完成后，你可以使用自然语言与你的 Airtable 数据交互：

"Show me all the bases I have access to" (显示我可以访问的所有数据库)
"List the tables in my current base" (列出我当前数据库中的表格)
"Show me the structure of the Customers table" (显示 Customers 表格的结构)
"Get the first 10 records from the Orders table" (从 Orders 表格中获取前 10 条记录)
"Create a new record in the Products table" (在 Products 表格中创建一个新记录)
"Update record XYZ in the Inventory table" (更新 Inventory 表格中的记录 XYZ)
"Export the schema of my current base" (导出我当前数据库的模式)

可用工具

工具名称	描述
`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`	使用指定的字段映射将数据从一个表格迁移到另一个表格

PM2 配置

对于生产用途，你可以使用 PM2 来管理 Airtable MCP 服务器：

// ecosystem.config.js
module.exports = {
  apps: [
    {
      name: 'airtable-mcp',
      script: 'npx',
      args: [
        'airtable-mcp',
        '--token', 'your_airtable_token',
        '--base', 'your_base_id'
      ],
      interpreter: '/usr/local/bin/node',
      env: {
        PATH: process.env.PATH,
      },
    },
  ],
};