Airtable MCP 服务器

简介

Airtable MCP 服务器是一个提供对 Airtable 数据库进行读写访问的模型上下文协议 (MCP) 服务器。该服务器能够自动发现和生成 Airtable 基础数据（base）和表格的模式信息，并提供了丰富的工具集用于操作 Airtable 的数据和结构。

使用说明

安装与配置

要使用 Airtable MCP 服务器，请按照以下步骤进行安装和配置：

1. 安装 Git 和 Node.js
2. 克隆仓库：

   git clone https://github.com/your-repository.git
   

3. 安装依赖项：

   npm install
   

4. 设置环境变量：
   • 配置 Airtable 的 API 令牌和基础 ID（Base ID）。
   • 示例配置文件 config.json：

     {
       "airtable": {
         "apiKey": "your_airtable_api_key",
         "baseId": "your_airtable_base_id"
       }
     }
     

核心功能

Airtable MCP 服务器提供了以下核心功能：

• 数据访问：支持对 Airtable 数据库的读写操作。
• 模式发现：自动发现和生成 Airtable 基础数据（base）和表格的模式信息。
• 结构管理：支持创建、更新和删除表格、字段等数据库对象。

工具集

数据操作工具

1. 查询数据：

   mcp query "SELECT * FROM airtable://your-base-id/your-table-id"
   

2. 插入数据：

   mcp insert --table your-table-id --data '{"field1": "value1", "field2": 123}'
   

3. 更新数据：

   mcp update --record-id rec0123456789 --data '{"field1": "newValue"}'
   

数据库对象管理工具

1. 创建表格：

   mcp create-table --baseId your-base-id --name "New Table" --description "This is a new table"
   

2. 更新表格：

   mcp update-table --baseId your-base-id --tableId your-table-id --newName "Updated Table"
   

3. 删除表格：

   mcp delete-table --baseId your-base-id --tableId your-table-id
   

字段管理工具

1. 创建字段：

   mcp create-field --baseId your-base-id --tableId your-table-id --name "New Field" --type "text"
   

2. 更新字段：

   mcp update-field --baseId your-base-id --tableId your-table-id --fieldId field123456789 --newName "Updated Field"
   

3. 删除字段：

   mcp delete-field --baseId your-base-id --tableId your-table-id --fieldId field123456789
   

资源信息

表格模式

Airtable MCP 服务器提供了以下表格模式资源信息：

• URL 格式：

  airtable://<baseId>/<tableId>/schema
  

• 包含内容：
  • 基础 ID 和表格 ID
  • 表格名称和描述
  • 主键字段 ID
  • 字段定义（ID、名称、类型、描述、选项）
  • 视图定义（ID、名称、类型）

贡献指南

欢迎通过 GitHub 提交拉取请求！要开始贡献，请按照以下步骤操作：

1. 安装 Git 和 Node.js
2. 克隆仓库：

   git clone https://github.com/your-repository.git
   

3. 安装依赖项：

   npm install
   

4. 运行测试：

   npm run test
   

5. 构建项目：
   • 使用命令 npm run build 进行一次性构建。
   • 或者使用 npm run build:watch 实现实时构建（编辑后自动重建）。

版本控制

当前版本：v1.0.0

许可证

该项目遵循 MIT 许可证。

联系方式

如有任何问题或建议，请联系：

• 邮箱：support@your-domain.com
• GitHub：https://github.com/your-repository