AI导哈

Airtable MCP服务器

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

  • by felores
  • JavaScript
  • 本地部署
  • 75 星标
  • 更新于
在 GitHub 查看 felores/airtable-mcp

使用说明

Airtable MCP服务器

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

此MCP服务器具有一个专门的实现，允许它分阶段构建表，利用Claude的代理功能，并在构建复杂表时将Airtable的其他MCP服务器中常见的故障率降至最低。它还包括 系统提示 和 项目知识 markdown文件，在利用Claude Desktop中的项目时为LLM提供额外的指导。

要求：Node.js

  1. 从以下位置安装Node.js（版本18或更高）和npm nodejs.org
  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：写入
  4. 选择要授予访问个人访问令牌权限的工作区或基地
  5. 请确保此密钥的安全——您需要它进行配置

安装

方法1：使用npx（推荐）

  1. 导航到Claude配置目录：

    • 窗户： 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安装程序：

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

  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上的fork
    • 点击“新建拉取请求”
    • 选择您的功能分支
    • 详细描述您的更改

开发指南

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

获取帮助

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

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

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

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

许可证

麻省理工学院

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

相关 MCP