Airtable

🚀 Airtable MCP 服務器

Airtable MCP 服務器是一個基於模型上下文協議（MCP）的服務器，它能提供對 Airtable 數據庫的讀寫訪問。該服務器可自動發現和生成 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. 安裝 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"
       }
     }
     

💻 使用示例

基礎用法

數據操作工具

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
   

高級用法

貢獻代碼

歡迎通過 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 實現即時構建（編輯後自動重建）。

📚 詳細文檔

資源信息

表格模式

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

• URL 格式：

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

• 包含內容：
  • 基礎 ID 和表格 ID
  • 表格名稱和描述
  • 主鍵字段 ID
  • 字段定義（ID、名稱、類型、描述、選項）
  • 視圖定義（ID、名稱、類型）

📄 許可證

該項目遵循 MIT 許可證。

📞 聯繫方式

如有任何問題或建議，請聯繫：

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

📌 版本信息

當前版本：v1.0.0