hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Enables programmatic management of Airtable bases, tables, fields, and records, with capabilities for creating and modifying tables, adding and updating fields with various data types, and performing CRUD operations on records.

Airtable MCP 服务器

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

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

要求：Node.js

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

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

获取 Airtable API 密钥

在airtable.com登录您的 Airtable 帐户
在Airtable 的 Builder Hub创建个人访问令牌
在个人访问令牌部分选择以下范围：
- 数据.记录：读取
- 数据.记录：写入
- schema.bases:读取
- schema.bases:写入
选择您想要授予个人访问令牌访问权限的工作区或基地
确保此密钥安全 - 您将需要它进行配置

安装

方法 1：使用 npx（推荐）

导航到 Claude 配置目录：
- Windows： C:\Users\NAME\AppData\Roaming\Claude
- macOS： ~/Library/Application Support/Claude/
您还可以在 Claude Desktop 应用程序中找到这些目录：Claude Desktop > 设置 > 开发人员 > 编辑配置
创建或编辑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 服务器。

安装mcp-installer
通过提示 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"
      }
    }
  }
}

验证安装

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

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 服务器做出贡献！您可以通过以下方式做出贡献：

分叉存储库
- 访问https://github.com/felores/airtable-mcp
- 点击右上角的“Fork”按钮
- 在本地克隆你的 fork：
  git clone https://github.com/your-username/airtable-mcp.git
创建功能分支
git checkout -b feature/your-feature-name
做出改变
- 遵循现有的代码风格
- 如果适用，添加测试
- 根据需要更新文档
提交你的更改
git add . git commit -m "feat: add your feature description"
推送到你的 Fork
git push origin feature/your-feature-name
创建拉取请求
- 前往 GitHub 上的 fork
- 点击“新建拉取请求”
- 选择你的功能分支
- 详细描述你的变化