hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Enables programmatic management of Airtable bases, tables, fields, and records, with capabilities for creating and modifying tables, adding and updating fields with various data types, and performing CRUD operations on records.

Airtable MCP サーバー

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

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のフォークに移動する
- 「新しいプルリクエスト」をクリックします
- 機能ブランチを選択してください
- 変更内容を詳しく説明してください