エアテーブルMCP

AIツールをAirtableに直接接続できます。自然言語でレコードのクエリ、作成、更新、削除が可能です。ベース管理、テーブル操作、スキーマ操作、レコードフィルタリング、データ移行などの機能をすべて、Cursor、Claude Code、Cline、ZedなどのClaudeベースのエディターと互換性のある標準化されたMCPインターフェースから利用できます。

このアプリケーションは、Anthropic の Model Context Protocol (MCP) を介して AI 搭載アプリケーションが IDE から直接 Airtable データにアクセスして操作できるようにする強力な Airtable 統合ツールです。

特徴

拠点管理: Airtable拠点の一覧表示と選択
テーブル操作: テーブル、フィールド、レコードを参照します
データアクセス: レコードの読み取り、作成、更新、削除
スキーマ管理: スキーマのエクスポート、比較、更新
コマンドライン構成: コマンドラインパラメータを通じてAPIトークンを直接使用する
NPX互換:コマンド1つで簡単にインストール
Smithery統合: Smithery経由のワンクリックインストール

建築

Airtable データにアクセスして操作するために使用されるコアコンポーネントは 2 つあります。

Airtable MCP サーバー: AI クライアントが Airtable と対話するための標準化されたツールを提供する Python サーバー。
MCP クライアント: モデルコンテキストプロトコル (Cursor、Claude Desktop、Cline、Zed など) をサポートする任意のクライアント。

┌─────────────┐     ┌──────────────┐     ┌───────────────┐
│  MCP Client │ ──► │  Airtable    │ ──► │   Airtable    │
│  (e.g.      │ ◄── │  MCP Server  │ ◄── │     API       │
│   Cursor)   │     │              │     │               │
└─────────────┘     └──────────────┘     └───────────────┘

モデルコンテキストプロトコル（MCP）は、Anthropic AIモデルがサポートする機能で、互換性のあるクライアント向けにカスタムツールを作成できます。Claude Desktop、Cursor、Cline、ZedなどのMCPクライアントは、MCPサーバーを実行できます。MCPサーバーは、これらのクライアントに新しいツールの使用方法を「教える」ことができます。

インストール

前提条件

Node.js 14以上
Python 3.10+ (自動検出)
Airtable APIトークン
互換性のある MCP クライアント (Cursor、Claude Desktop など)

鍛冶屋のインストール（推奨）

最も簡単なインストール方法:

スミザリーを訪れる
「@rashidazarang/airtable-mcp」を検索
「インストール」をクリックし、指示に従ってください

NPX によるクイックセットアップ (代替)

もう一つの早い開始方法:

# Install globally
npm install -g airtable-mcp

# Or run directly with npx
npx airtable-mcp --token "your_airtable_token" --base "your_base_id"

MCPクライアントを構成する

カーソルの場合は、 ~/.cursor/mcp.jsonファイルを更新します。

{
  "mcpServers": {
    "airtable-tools": {
      "command": "npx",
      "args": [
        "airtable-mcp",
        "--token", "your_airtable_token",
        "--base", "your_base_id"
      ]
    }
  }
}

新しいツールをロードするには、MCP クライアントを再起動します。

手動インストール（上級）

リポジトリのクローンを作成して手動でインストールする場合:

このリポジトリをクローンします:
git clone https://github.com/rashidazarang/airtable-mcp.git cd airtable-mcp
依存関係をインストールします:
pip install -r requirements.txt
サーバーを実行します。
python airtable_mcp/src/server.py --token "your_airtable_token" --base "your_base_id"

使用法

インストールして設定したら、自然言語を使用して Airtable データを操作できるようになります。

「私がアクセスできる基地をすべて見せてください」
「現在のベース内のテーブルを一覧表示する」
「顧客テーブルの構造を教えてください」
「Ordersテーブルから最初の10件のレコードを取得する」
「製品テーブルに新しいレコードを作成する」
「在庫テーブルのレコードXYZを更新する」
「現在のベースのスキーマをエクスポートする」

利用可能なツール

ツール名	説明
`list_bases`	アクセス可能なすべてのAirtableベースを一覧表示する
`list_tables`	指定されたベースまたはデフォルトのベースにあるすべてのテーブルを一覧表示します
`list_records`	オプションのフィルタリングを使用してテーブルからレコードを一覧表示する
`get_record`	テーブルから特定のレコードを取得する
`create_records`	JSON文字列からテーブルにレコードを作成する
`update_records`	JSON文字列からテーブル内のレコードを更新する
`delete_records`	IDでテーブルからレコードを削除する
`export_records`	テーブルからレコードをJSON文字列としてエクスポートする
`import_records`	JSON文字列からテーブルにレコードをインポートする
`create_tables`	JSONスキーマからテーブルを作成する
`update_schema`	JSONスキーマに一致するように既存のテーブルを更新する
`set_base_id`	現在のAirtableベースIDを設定する
`inspect_table`	テーブルの構造とフィールドに関する詳細情報を取得します
`export_schema`	現在のベースのスキーマをJSONまたはCSV形式でエクスポートします
`compare_schemas`	提供されたスキーマを現在のベーススキーマと比較します
`generate_field_mapping`	2つのテーブル間のフィールドマッピングを生成する
`migrate_data`	指定されたフィールドマッピングを使用して、あるテーブルから別のテーブルにデータを移行します。

PM2構成

実稼働環境では、PM2 を使用して Airtable MCP サーバーを管理できます。

// ecosystem.config.js
module.exports = {
  apps: [
    {
      name: 'airtable-mcp',
      script: 'npx',
      args: [
        'airtable-mcp',
        '--token', 'your_airtable_token',
        '--base', 'your_base_id'
      ],
      interpreter: '/usr/local/bin/node',
      env: {
        PATH: process.env.PATH,
      },
    },
  ],
};

まず始めに:

pm2 start ecosystem.config.js

互換性

MCP互換クライアントならどれでも動作します
主にカーソルIDE統合用に設計されています
他のAIエディターとMCPクライアントをサポート

詳細なドキュメント

詳細なインストール手順、トラブルシューティング、および高度な構成については、 INSTALLATION.md を参照してください。

ライセンス

マサチューセッツ工科大学

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

Integrations