Airtable MCP 服务器

一个模型上下文协议服务器，提供与 Airtable API 交互的工具。该服务器支持通过 Claude Desktop 或其他 MCP 客户端以编程方式管理 Airtable 的库、表、字段和记录。

该 MCP 服务器具有专门的实现，允许其分阶段构建表格，充分利用 Claude 的代理功能，并最大限度地降低其他 Airtable MCP 服务器在构建复杂表格时常见的失败率。它还包含系统提示和项目知识Markdown 文件，为法学硕士 (LLM) 在 Claude Desktop 中利用项目时提供额外指导。

要求：Node.js

1. 从nodejs.org安装 Node.js（版本 18 或更高版本）和 npm

2. 验证安装：

   node --version npm --version

⚠️重要提示：运行之前，请务必设置您的 Airtable API 密钥

Related MCP server: Calculator MCP Server

获取 Airtable API 密钥

1. 在airtable.com登录您的 Airtable 帐户

2. 在Airtable 的 Builder Hub创建个人访问令牌

3. 在个人访问令牌部分选择以下范围：

   • 数据.记录：读取

   • 数据.记录：写入

   • schema.bases:读取

   • schema.bases:写入

4. 选择您想要授予个人访问令牌访问权限的工作区或基地

5. 确保此密钥安全 - 您将需要它进行配置

安装

方法 1：使用 npx（推荐）

1. 导航到 Claude 配置目录：

   • Windows： C:\Users\NAME\AppData\Roaming\Claude

   • macOS： ~/Library/Application Support/Claude/

   您还可以在 Claude Desktop 应用程序中找到这些目录：Claude Desktop > 设置 > 开发人员 > 编辑配置

2. 创建或编辑claude_desktop_config.json ：

注意：对于 Windows 路径，请使用双反斜杠 (\) 或正斜杠 (/)。

方法 2：使用 mcp-installer：

mcp-installer 是一个用于安装其他 MCP 服务器的 MCP 服务器。

1. 安装mcp-installer

2. 通过提示 Claude Desktop 安装 Airtable MCP 服务器：

Claude 将安装服务器，修改配置文件并将环境变量 AIRTABLE_API_KEY 设置为您的 Airtable API 密钥。

方法3：本地开发安装

如果您想贡献或修改代码，请在终端中运行此命令：

然后修改Claude Desktop配置文件以使用本地安装：

验证安装

1. 启动 Claude Desktop

2. Airtable MCP 服务器应列在“已连接的 MCP 服务器”部分中

3. 使用简单命令进行测试：

特征

可用操作

基地管理

• list_bases ：列出所有可访问的 Airtable 基础

• list_tables ：列出基础中的所有表

• create_table ：创建一个带有字段的新表

• update_table ：更新表的名称或描述

现场管理

• create_field ：向表中添加新字段

• update_field ：修改现有字段

记录操作

• list_records ：从表中检索记录

• create_record ：添加新记录

• update_record ：修改现有记录

• delete_record ：删除记录

• search_records ：查找符合条件的记录

• get_record ：通过 ID 获取单个记录

字段类型

• singleLineText ：单行文本字段

• multilineText ：多行文本区域

• email ：电子邮件地址字段

• phoneNumber ：电话号码字段

• number ：具有可选精度的数字字段

• currency ：带有货币符号的货币字段

• date ：带有格式选项的日期字段

• singleSelect ：从选项中单选

• multiSelect ：选项中的多个选择

字段颜色

选定字段的可用颜色：

• blueBright ， redBright ， greenBright

• yellowBright ， purpleBright ， pinkBright

• grayBright ， cyanBright ， orangeBright

• blueDark1 ， greenDark1

贡献

我们欢迎您为改进 Airtable MCP 服务器做出贡献！您可以通过以下方式做出贡献：

1. 分叉存储库

   • 访问https://github.com/felores/airtable-mcp

   • 点击右上角的“Fork”按钮

   • 在本地克隆你的 fork：

     git clone https://github.com/your-username/airtable-mcp.git

2. 创建功能分支

   git checkout -b feature/your-feature-name

3. 做出改变

   • 遵循现有的代码风格

   • 如果适用，添加测试

   • 根据需要更新文档

4. 提交你的更改

   git add . git commit -m "feat: add your feature description"

5. 推送到你的 Fork

   git push origin feature/your-feature-name

6. 创建拉取请求

   • 前往 GitHub 上的 fork

   • 点击“新建拉取请求”

   • 选择你的功能分支

   • 详细描述你的变化

开发指南

• 使用 TypeScript 编写新代码

• 遵循语义提交消息

• 更新新功能的文档

• 添加新功能的示例

• 彻底测试您的更改

获取帮助

• 针对错误或功能请求打开问题

• 加入现有问题的讨论

• 在拉取请求中提问

您的贡献有助于改进此工具，使其更适合所有人。无论是：

• 添加新功能

• 修复错误

• 改进文档

• 建议改进

我们感谢您的帮助，使 Airtable MCP 服务器更加强大和用户友好！

执照

麻省理工学院

由 Airtable MCP 社区倾情打造