Airtable MCP Server

Airtable MCP サーバー

Airtable APIを操作するためのツールを提供するモデルコンテキストプロトコル（MCP）サーバー。このサーバーは、Claude Desktopやその他のMCPクライアントを介して、Airtableのベース、テーブル、フィールド、レコードをプログラムで管理することを可能にします。

このMCPサーバーは、Claudeのエージェント機能を活用し、段階的にテーブルを構築できる特別な実装を採用しています。これにより、複雑なテーブル構築時に他のAirtable向けMCPサーバーで一般的に見られる失敗率を最小限に抑えることができます。また、システムプロンプトとプロジェクトナレッジマークダウンファイルも含まれており、Claude Desktopのプロジェクトを活用する際にLLMに追加のガイダンスを提供します。

要件: Node.js

1. nodejs.orgから Node.js (バージョン 18 以上) と npm をインストールします。
2. インストールを確認します:
   node --version npm --version

⚠️重要: 実行する前に、Airtable APIキーを設定してください

Airtable APIキーの取得

1. airtable.comでAirtableアカウントにログインしてください
2. Airtableのビルダーハブで個人アクセストークンを作成する
3. 個人アクセス トークン セクションで、次のスコープを選択します。
   • データ.レコード:読み取り
   • データ.レコード:書き込み
   • schema.bases:読み取り
   • schema.bases:書き込み
4. 個人アクセストークンへのアクセスを許可するワークスペースまたはベースを選択します
5. このキーは安全に保管してください。設定に必要になります。

インストール

方法1: npxを使用する（推奨）

1. Claude 構成ディレクトリに移動します。
   • Windows: C:\Users\NAME\AppData\Roaming\Claude
   • macOS: ~/Library/Application Support/Claude/

   Claude Desktop アプリ内にも以下のディレクトリがあります: Claude Desktop > 設定 > 開発者 > 設定の編集

2. claude_desktop_config.jsonを作成または編集します。

注: Windows パスの場合は、二重のバックスラッシュ (\) またはスラッシュ (/) を使用します。

方法 2: mcp-installer を使用する:

mcp-installer は、他の MCP サーバーをインストールするための MCP サーバーです。

1. mcp-installerをインストールする
2. Claude Desktop にプロンプトを表示して、Airtable MCP サーバーをインストールします。

Claude はサーバーをインストールし、構成ファイルを変更し、環境変数 AIRTABLE_API_KEY を Airtable API キーに設定します。

方法3: ローカル開発インストール

コードに貢献したり変更したい場合は、ターミナルでこれを実行してください。

次に、ローカル インストールを使用するように Claude Desktop 構成ファイルを変更します。

インストールの確認

1. Claudeデスクトップを起動
2. Airtable MCPサーバーは「接続されたMCPサーバー」セクションにリストされているはずです。
3. 簡単なコマンドでテストします。

特徴

利用可能な操作

基地管理

• list_bases : アクセス可能なすべてのAirtableベースを一覧表示する
• list_tables : ベース内のすべてのテーブルを一覧表示する
• create_table : フィールドを持つ新しいテーブルを作成する
• update_table : テーブルの名前または説明を更新する

フィールド管理

• create_field : テーブルに新しいフィールドを追加する
• update_field : 既存のフィールドを変更する

レコード操作

• list_records : テーブルからレコードを取得する
• create_record : 新しいレコードを追加する
• update_record : 既存のレコードを変更する
• delete_record : レコードを削除する
• search_records : 条件に一致するレコードを検索する
• get_record : IDで1つのレコードを取得する

フィールドタイプ

• singleLineText : 1行テキストフィールド
• multilineText : 複数行テキストエリア
• email : メールアドレスフィールド
• phoneNumber : 電話番号フィールド
• number : 精度をオプションで指定できる数値フィールド
• currency : 通貨記号付きの金額フィールド
• date : フォーマットオプション付きの日付フィールド
• singleSelect : オプションからの単一の選択
• multiSelect : オプションからの複数選択

フィールドカラー

選択したフィールドで使用可能な色:

• blueBright 、 redBright 、 greenBright
• yellowBright 、 purpleBright 、 pinkBright
• grayBright 、 cyanBright 、 orangeBright
• blueDark1 、 greenDark1

貢献

Airtable MCP サーバーの改善に向けた貢献を歓迎します。貢献方法は以下の通りです。

1. リポジトリをフォークする
   • https://github.com/felores/airtable-mcpにアクセスしてください
   • 右上の「フォーク」ボタンをクリックします
   • フォークをローカルにクローンします。
     git clone https://github.com/your-username/airtable-mcp.git
2. 機能ブランチを作成する
   git checkout -b feature/your-feature-name
3. 変更を加える
   • 既存のコードスタイルに従う
   • 該当する場合はテストを追加する
   • 必要に応じてドキュメントを更新する
4. 変更をコミットする
   git add . git commit -m "feat: add your feature description"
5. フォークにプッシュする
   git push origin feature/your-feature-name
6. プルリクエストを作成する
   • GitHubのフォークに移動する
   • 「新しいプルリクエスト」をクリックします
   • 機能ブランチを選択してください
   • 変更内容を詳しく説明してください

開発ガイドライン

• 新しいコードにはTypeScriptを使用する
• セマンティックコミットメッセージに従う
• 新機能のドキュメントを更新
• 新しい機能の例を追加する
• 変更を徹底的にテストする

ヘルプの取得

• バグや機能リクエストについては問題を開いてください
• 既存の問題に関する議論に参加する
• プルリクエストで質問する

あなたの貢献は、このツールをより良くするために役立ちます。例えば、

• 新機能の追加
• バグの修正
• ドキュメントの改善
• 機能強化の提案

Airtable MCP サーバーをより強力でユーザーフレンドリーなものにするためにご協力いただきありがとうございます。

ライセンス

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

Airtable MCPコミュニティによって❤️で作られました