Airtable MCP 服务器

一个模式背景协议服务器,提供与Airtable的API互动的工具. 这个服务器能够通过克洛德桌面或其他MCP客户端对Airtable基地,表格,字段和记录进行程序管理.

这个MCP服务器具有专门的执行功能,使其能够分阶段地构建表格,利用克洛德的代理能力,并最大限度地降低其他MCP服务器在构建复杂表格时通常看到的Airtable故障率. 它还包括系统提示,在克洛德桌面上利用项目时为LLM提供额外的指导.

安装

⚠️ 重要:在运行前,确保:

1. 设置您的 Airtable API 密钥( 见 API 密钥设置(中文(简体) )
2. 配置 Claude 桌面( 见 配置(中文(简体) )

方法1:使用npx(建议)

使用 npx 运行服务器的最简单方式 :

# Run directly (will install latest version)
npx airtable-server

# Or specify a version
npx [email protected]

方法2:使用 mcp- 安装器数字 :

在安装了mcp-installer后,您可以通过提示克洛德桌面安装 Airtable MCP 服务器:

Install the MCP server: airtable-server. Set the environment variable AIRTABLE_API_KEY to 'your_airtable_api_key_here'

Claude将安装服务器,修改配置文件,并将环境变量ARTABLE 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

获取空表 API 密钥

1. 登录到您的 Airtable 账户 (原始内容存档于2018-10-21). airtable.com
2. 在 Airtable 的构建器枢纽
3. 在个人访问符部分选择这些范围:
   • 数据。记录:已读
   • 数据。记录:写入
   • 计划. bases: read
   • 计划. bases: write
4. 选择您想要访问个人访问符的工作空间或基地
5. 保管这个密钥 - 您需要它来配置

配置 Claude 桌面

1. 导航到 Claude 配置目录 :

   • 窗口 : C:\Users\NAME\AppData\Roaming\Claude
   • 马可斯: ~/Library/Application Support/Claude/

   (您也可以在 Claude 桌面 > 设置 > 开发者 > 编辑配置中找到这些目录)

2. 创建或编辑 claude_desktop_config.json数字 :

Npx 安装 :

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

当地安装:

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

注意: 对于Windows路径,使用双回鞭 (\) 或前向鞭 (/).

正在验证安装

1. 启动克洛德桌面
2. Airtable MCP服务器应该列在"连接的MCP服务器"部分
3. 使用简单命令进行测试 :

List all bases

特征

可用操作

基地管理

• list_bases: 列出所有可进入的空表基地
• list_tables: 在基数中列出所有表格
• create_table: 创建一个带有字段的新表格
• update_table: 更新表格的名称或说明

外地管理

• create_field: 在表格中添加新字段
• update_field: 修改已存在的字段

记录操作

• list_records: 从表格中获取记录
• create_record: 添加新记录
• update_record: 修改已存在的记录
• delete_record: 删除记录
• search_records: 查找匹配标准的记录
• get_record: 以其身份获得单一记录

字段类型

• singleLineText: 单行文字字段
• multilineText: 多行文本区域
• email电子邮件地址字段
• phoneNumber: 电话号码字段
• number: 可选精度的数字字段
• currency: 有货币符号的货币字段
• date: 带有格式选项的日期字段
• singleSelect: 从选项中选择一个
• multiSelect: 从选项中选择多个选项

字段颜色

选定字段可用的颜色 :

• blueBright, (中文(简体) ), redBright, (中文(简体) ), greenBright
• yellowBright, (中文(简体) ), purpleBright, (中文(简体) ), pinkBright
• grayBright, (中文(简体) ), cyanBright, (中文(简体) ), orangeBright
• blueDark1, (中文(简体) ), greenDark1

捐款

我们欢迎为改进空气表MCP服务器做出贡献! 这就是你如何贡献:

1. 叉存储器

   • 访问 https://github.com/felores/airtable-mcp 页面存档备份,存于互联网档案馆
   • 单击右上方的“叉”按钮
   • 切开你的叉子:

     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
   • 点击“ 新拉请求 ”
   • 选择您的特性分支
   • 详细描述您的变化

发展指导方针

• 新代码使用类型脚本
• 跟随语义输入消息
• 更新新功能的文件
• 为新功能添加示例
• 彻底测试您的更改

获取帮助

• 为错误或特性请求打开一个问题
• 共同讨论现有问题
• 在拉动请求中询问问题

你们的贡献有助于使这个工具更好地为所有人服务。 是否为:

• 添加新特性
• 修复错误
• 改进文件编制
• 建议加强

我们很感激你帮助 使AirTable MCP服务器更强大 更方便用户!

许可证

麻省理工学院

由空气表MCP社区制造