Airtable MCP サーバー

Name: Airtable MCP Server
Author: felores

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

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

要件: Node.js

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

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

Related MCP server: Calculator MCP Server

Airtable APIキーの取得

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

インストール

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

Claude 構成ディレクトリに移動します。
- Windows: C:\Users\NAME\AppData\Roaming\Claude
- macOS: ~/Library/Application Support/Claude/
Claude Desktop アプリ内にも以下のディレクトリがあります: Claude Desktop > 設定 > 開発者 > 設定の編集
claude_desktop_config.jsonを作成または編集します。

{ "mcpServers": { "airtable": { "command": "npx", "args": ["@felores/airtable-mcp-server"], "env": { "AIRTABLE_API_KEY": "your_api_key_here" } } } }

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

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

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

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

Install @felores/airtable-mcp-server set the environment variable AIRTABLE_API_KEY to 'your_api_key'

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

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

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

# Clone the repository git clone https://github.com/felores/airtable-mcp.git cd airtable-mcp # Install dependencies npm install # Build the server npm run build # Run locally node build/index.js

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

{ "mcpServers": { "airtable": { "command": "node", "args": ["path/to/airtable-mcp/build/index.js"], "env": { "AIRTABLE_API_KEY": "your_api_key_here" } } } }

インストールの確認

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

List all bases

特徴

利用可能な操作

基地管理

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 サーバーの改善に向けた貢献を歓迎します。貢献方法は以下の通りです。

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

開発ガイドライン

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

ヘルプの取得

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

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

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

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

ライセンス

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

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

Airtable MCP Server