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キーを設定してください

Related MCP server: my-mcp-server

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を作成または編集します。

{
 "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 サーバーです。

1. mcp-installerをインストールする

2. 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"
 }
 }
 }
}

インストールの確認

1. Claudeデスクトップを起動

2. Airtable MCPサーバーは「接続されたMCPサーバー」セクションにリストされているはずです。

3. 簡単なコマンドでテストします。

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

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コミュニティによって❤️で作られました

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• create_fieldC
• create_recordC
• create_tableC
• delete_recordC
• get_recordC
• list_basesB
• list_recordsC
• list_tablesB