项目简介
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 一键安装
- 访问 Smithery。
- 搜索 "@rashidazarang/airtable-mcp"。
- 点击 "Install" 并按照 Smithery 的提示完成安装。
备选方式:NPX 快速安装
- 确保已安装 Node.js (14+) 和 Python (3.10+)。
- 打开终端,运行以下命令全局安装 'airtable-mcp':
npm install -g airtable-mcp - 或者使用 'npx' 直接运行:
请将 '"您的_Airtable_API_令牌"' 替换为您的 Airtable 个人访问令牌,'"您的_Base_ID"' 替换为您的 Airtable Base ID。npx airtable-mcp --token "您的_Airtable_API_令牌" --base "您的_Base_ID"
手动安装(高级用户)
- 克隆 GitHub 仓库到本地:
git clone https://github.com/rashidazarang/airtable-mcp.git cd airtable-mcp - 安装 Python 依赖:
pip install -r requirements.txt - 运行服务器:
同样需要替换令牌和 Base ID。python3.10 inspector_server.py --token "您的_Airtable_API_令牌" --base "您的_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 中,您可以:
- 列出 Airtable 库 (Base):在编辑器中输入或选择 'list_bases' 工具,即可查看您 Airtable 账户下的所有库。
- 列出表 (Table):使用 'list_tables' 工具,可以查看指定库中的所有表。
- 查询记录 (Record):使用 'list_records' 工具,输入表名和可选的过滤条件,即可查询表中的记录。
- 获取指定记录:使用 'get_record' 工具,输入表名和记录 ID,获取特定记录的详细信息。
- 创建记录:使用 'create_records' 工具,输入表名和 JSON 格式的记录数据,即可在表中创建新记录。
- 更新记录:使用 'update_records' 工具,输入表名和包含记录 ID 及更新字段的 JSON 数据,更新现有记录。
- 设置当前 Base ID: 使用 'set_base_id' 工具,设置后续操作的默认 Airtable Base。
具体工具的使用方法和参数,请参考仓库 'README.md' 文件中 "Available Tools" 部分的详细描述。您可以在 MCP 客户端中通过自然语言指令或工具选择界面来调用这些工具,实现与 Airtable 数据的智能交互。
信息
分类
生产力应用