Airtable MCP Server

Airtable MCP服务器

模型上下文协议服务器，提供与Airtable的API交互的工具。此服务器允许通过Claude Desktop或其他MCP客户端对Airtable库、表、字段和记录进行程序化管理。

要求：Node.js

1. 从以下位置安装Node.js（版本18或更高）和npm
2. 验证安装：

   node --version
   npm --version

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

获取Airtable API密钥

1. 登录您的Airtable帐户 网站：airtable.com
2. 在以下位置创建个人访问令牌 Airtable的Builder Hub
3. 在“个人访问令牌”部分，选择以下范围：

- data.records：读取 - data.records：写入 - schema.bases:读取 - schema.bases：写入

1. 选择要授予访问个人访问令牌权限的工作区或基地
2. 请确保此密钥的安全——您需要它进行配置

安装

方法1：使用npx（推荐）

1. 导航到Claude配置目录：

- 窗户： C:\Users\NAME\AppData\Roaming\Claude - macOS： ~/Library/Application Support/Claude/

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

1. 创建或编辑 claude_desktop_config.json:

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

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

方法2：使用mcp安装程序：

mcp安装程序是一个用于安装其他mcp服务器的mcp服务器。

1. 安装 mcp安装程序
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. 启动克劳德桌面
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 - 点击右上角的“分叉”按钮 - 在本地克隆您的分叉：

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

1. 创建要素分支

   git checkout -b feature/your-feature-name

1. 进行更改

- 遵循现有代码样式 - 如果适用，添加测试 - 根据需要更新文档

1. 提交您的更改

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

1. 推到你的叉子

   git push origin feature/your-feature-name

1. 创建拉取请求

- 转到GitHub上的fork - 点击“新建拉取请求” - 选择您的功能分支 - 详细描述您的更改

开发指南

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

获取帮助

• 为bug或功能请求打开问题
• 加入现有问题的讨论
• 在pull请求中提问

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

• 添加新功能
• 修复bug
• 改进文件
• 建议增强功能

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

许可证

麻省理工学院

______________________________________________________________________

由以下材料制成❤️ Airtable MCP社区