airtable-mcp-server

airtable-mcp-server

site icon
2025.02.17 1
TypeScript数据库中间件Airtable集成数据管理数据库开发效率
airtable-mcp-server 是一个基于 Model Context Protocol 的服务,提供对 Airtable 数据库的读写访问能力。该服务使 LLMs(大型语言模型)能够检查数据库模式,并读取和写入记录。
View on GitHub

Overview

基本能力

产品定位

airtable-mcp-server 是一个数据库访问中间件,专门为 Airtable 数据库提供标准化的读写接口,方便 LLMs 集成和使用 Airtable 数据。

核心功能

  • 提供对 Airtable 数据库的完整 CRUD 操作
  • 支持数据库模式检查和元数据查询
  • 提供丰富的查询和过滤能力
  • 支持表和字段级别的管理操作

适用场景

  • LLM 应用需要访问结构化数据存储
  • 需要将 Airtable 作为后端数据库的应用
  • 需要自动化管理 Airtable 数据的场景
  • 开发需要与 Airtable 集成的工具或服务

工具列表

  1. list_records - 列出指定 Airtable 表中的记录
  2. search_records - 在表中搜索包含特定文本的记录
  3. list_bases - 列出所有可访问的 Airtable 数据库
  4. list_tables - 列出指定数据库中的所有表
  5. get_record - 通过 ID 获取特定记录
  6. create_record - 在表中创建新记录
  7. update_records - 更新表中的一条或多条记录
  8. delete_records - 从表中删除一条或多条记录
  9. create_table - 在数据库中创建新表
  10. update_table - 更新表的名称或描述
  11. create_field - 在表中创建新字段
  12. update_field - 更新字段的名称或描述

常见问题解答

  • 需要提供有效的 Airtable 个人访问令牌
  • 令牌至少需要 schema.bases:readdata.records:read 权限
  • 如需写操作,还需要相应的写权限

使用教程

使用依赖

  1. 安装 Node.js (推荐最新 LTS 版本)
  2. 确保已安装 npm 或 yarn

安装教程

  1. 在 Claude Desktop 应用的配置文件中添加以下配置:
{
  "mcpServers": {
    "airtable": {
      "command": "npx",
      "args": [
        "-y",
        "airtable-mcp-server",
        "你的Airtable个人访问令牌"
      ]
    }
  }
}
  1. 你的Airtable个人访问令牌 替换为实际的 Airtable 令牌

调试方式

  1. 安装完成后,可以通过 Claude Desktop 应用测试连接
  2. 使用 list_bases 工具验证是否能正确获取数据库列表
  3. 使用 list_tables 工具验证是否能正确获取表结构
  4. 使用 get_record 工具测试数据读取功能
  5. 使用 create_record 工具测试数据写入功能

开发贡献

  1. 安装 Git 和 Node.js
  2. 克隆仓库
  3. 运行 npm install 安装依赖
  4. 运行 npm run test 执行测试
  5. 使用 npm run build 构建项目
  6. 使用 npm run build:watch 进行开发时自动构建

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。