Airtable MCP 服务器

这是一个提供与 Airtable API 交互工具的模型上下文协议 (MCP) 服务器。该服务器通过 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 账户 airtable.com
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：本地开发安装

如果您希望贡献代码或修改代码，请在终端中运行以下命令：

# Clone the repository
git clone https://github.com/felores/airtable-mcp.git
cd airtable-mcp

# Install dependencies
npm install

# Build the server
npm run build

# Run locally
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. 分叉仓库

   • 访问 https://github.com/felores/airtable-mcp
   • 点击右上角的“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. 推送到您的分叉

   git push origin feature/your-feature-name
   

6. 创建拉取请求

   • 前往 GitHub 上的您的分叉
   • 点击“New Pull Request”
   • 选择您的功能分支
   • 详细描述您的更改

开发指南

• 使用 TypeScript 编写新代码
• 遵循语义化的提交信息
• 更新新功能的相关文档
• 为新功能添加示例
• 彻底测试您的更改

获取帮助

• 对于错误或功能请求，请打开问题
• 加入现有问题中的讨论
• 在拉取请求中提问

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

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

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

许可证

MIT

由 Airtable MCP 社区以 ❤️ 制作