空气表-mcp

Name: 空气表-mcp
Author: felores

作者：felores70 星标更新：2025-01-28

安装使用来源：spider==github.com

项目介绍

Airtable MCP 服务器

这是一个提供与 Airtable API 交互工具的 Model Context Protocol 服务器。此服务器通过 Claude Desktop 或其他 MCP 客户端实现对 Airtable 数据库、表、字段和记录的程序化管理。

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

要求：Node.js

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

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

获取 Airtable API 密钥

登录到您的 Airtable 帐户 airtable.com
在 Airtable 的 Builder Hub 创建一个个人访问令牌
在个人访问令牌部分选择这些范围：
- data.records:read
- data.records:write
- schema.bases:read
- schema.bases:write
选择您要授予个人访问令牌访问权限的工作区或数据库
保管好这个密钥——配置时需要它

安装

方法 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：本地开发安装

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

# 克隆仓库
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"
      }
    }
  }
}

验证安装

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

列出所有数据库

功能

可用操作

数据库管理

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
- 点击右上角的“分叉”按钮
- 将您的分叉克隆到本地：
```
git clone https://github.com/your-username/airtable-mcp.git
```

创建功能分支

git checkout -b feature/your-feature-name

进行更改
- 遵循现有的代码风格
- 如适用，添加测试
- 根据需要更新文档

提交更改

git add .
git commit -m "feat: 添加您的功能描述"

推送到您的分叉

git push origin feature/your-feature-name

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

开发指南

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

获取帮助

打开问题报告错误或功能请求
加入现有问题的讨论
在拉取请求中提问

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

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

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

许可

MIT

由 Airtable MCP 社区制作 ❤️