Airtable MCP 服务器

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

此 MCP 服务器具有专门的实现，允许它分阶段构建表格，利用 Claude 的代理能力，并最大限度地降低在其他 Airtable MCP 服务器上构建复杂表格时常见的失败率。它还包括 系统提示 和 项目知识 markdown 文件，以便在使用 Claude Desktop 中的项目时为 LLM 提供额外的指导。

要求：Node.js

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

   node --version
   npm --version
   

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

获取 Airtable API 密钥

1. 在 airtable.com 登录您的 Airtable 帐户
2. 在 Airtable 的 Builder Hub 创建个人访问令牌
3. 在“个人访问令牌”部分中，选择以下范围：
   • data.records:read
   • data.records:write
   • schema.bases:read
   • schema.bases:write
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：

{
  "mcpServers": {
    "airtable": {
      "command": "npx",
      "args": ["@felores/airtable-mcp-server"],
      "env": {
        "AIRTABLE_API_KEY": "your_api_key_here"
      }
    }
  }
}

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

方法 2：使用 mcp-installer：

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

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

Install @felores/airtable-mcp-server set the environment variable AIRTABLE_API_KEY to 'your_api_key'

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

方法 3：本地开发安装

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

# 克隆存储库
git clone https://github.com/felores/airtable-mcp.git
cd airtable-mcp

# 安装依赖项
npm install

# 构建服务器
npm run build

# 本地运行
node build/index.js

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

{
  "mcpServers": {
    "airtable": {
      "command": "node",
      "args": ["path/to/airtable-mcp/build/index.js"],
      "env": {
        "AIRTABLE_API_KEY": "your_api_key_here"
      }
    }
  }
}

验证安装

1. 启动 Claude Desktop
2. Airtable MCP 服务器应在“已连接的 MCP 服务器”部分中列出
3. 使用一个简单的命令进行测试：

List all bases

功能

可用操作

数据库管理

• 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. Fork 存储库

   • 访问 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. 创建一个 Pull Request

   • 转到 GitHub 上的 fork
   • 单击“New Pull Request”
   • 选择您的功能分支
   • 详细描述您的更改

开发指南

• 对新代码使用 TypeScript
• 遵循语义提交消息
• 更新新功能的文档
• 为新功能添加示例
• 彻底测试您的更改

获得帮助

• 为错误或功能请求打开一个 issue
• 加入现有 issue 中的讨论
• 在 pull request 中提问

您的贡献有助于使此工具对每个人都更好。无论是：

• 添加新功能
• 修复错误
• 改进文档
• 建议增强功能

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

许可证

MIT

---

由 Airtable MCP 社区用 ❤️ 制作