Airtable

🚀 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) とテーブルのスキーマ情報を自動的に検出して生成します。
• 構造管理：テーブルやフィールドなどのデータベースオブジェクトの作成、更新、削除をサポートします。

💻 使用例

データ操作ツール

基本的な使用法

# データをクエリする
mcp query "SELECT * FROM airtable://your-base-id/your-table-id"

高度な使用法

# データを挿入する
mcp insert --table your-table-id --data '{"field1": "value1", "field2": 123}'

# データを更新する
mcp update --record-id rec0123456789 --data '{"field1": "newValue"}'

データベースオブジェクト管理ツール

基本的な使用法

# テーブルを作成する
mcp create-table --baseId your-base-id --name "New Table" --description "This is a new table"

高度な使用法

# テーブルを更新する
mcp update-table --baseId your-base-id --tableId your-table-id --newName "Updated Table"

# テーブルを削除する
mcp delete-table --baseId your-base-id --tableId your-table-id

フィールド管理ツール

基本的な使用法

# フィールドを作成する
mcp create-field --baseId your-base-id --tableId your-table-id --name "New Field" --type "text"

高度な使用法

# フィールドを更新する
mcp update-field --baseId your-base-id --tableId your-table-id --fieldId field123456789 --newName "Updated Field"

# フィールドを削除する
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