AITable Mcp Server

AITable MCP サーバー

AITable.aiへの読み取りおよび書き込みアクセスを提供するModel Context Protocolサーバーです。このサーバーを使うと、LLMはAITable.aiのスペースの一覧表示、ノードの検索、レコードの一覧表示と作成、添付ファイルのアップロードを行えます。

ツール

ツール名	利用可能	説明
list_spaces	✅	現在認証されているユーザーがアクセス権を持つすべてのワークスペースを取得します。
search_nodes	✅	指定したタイプ、権限、クエリに基づいてノードを取得します。
list_records	✅	ページネーション、フィールドによる絞り込み、並べ替えオプションに対応して、指定したデータベースのレコードを読み取ります。
get_fields_schema	✅	指定したデータベース内のすべてのフィールドのJSONスキーマを返します
create_record	✅	データベースに新しいレコードを作成します。
upload_attachment_via_url	✅	Web URLを使用してAITableサーバーに添付ファイルをアップロードします。
update_record	❌	TODO

環境変数

• AITABLE_API_KEY：AITableの個人用アクセストークンです。
• AITABLE_BASE_URL：AITable APIのベースURLです。デフォルトはhttps://aitable.ai/fusionです。APITable（AITableのオープンソース版）を使用している場合は、{YOUR_CUSTOM_BASE_URL}を設定できます。

使い方

このサーバーは、Claude Desktop、CherryStudioなどのMCPクライアントで使用できます。

Claude Desktop Claude Desktopの場合、claude_desktop_config.jsonファイルの「mcpServers」セクションに、次の設定情報を追加する必要があります。

Linux、MacOSの場合：

{
  "mcpServers": {
    "aitable": {
      "command": "npx",
      "args": [
        "-y",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/aitable-mcp-server"
      ],
      "env": {
        "AITABLE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Windowsの場合：

{
  "mcpServers": {
    "aitable": {
      "command": "npx",
      "args": [
        "-y",
        "D:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\aitable-mcp-server"
      ],
      "env": {
        "AITABLE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

YOUR_API_KEYをAITableの個人用アクセストークンに、/ABSOLUTE/PATH/TO/PARENT/FOLDER/aitable-mcp-serverをこのリポジトリの親フォルダーへの絶対パスに置き換えてください。

CherryStudio CherryStudioをMCPクライアントとしてWindowsで使用する場合、設定は次のようになります。

{
  "mcpServers": {
    "aitable": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "D:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\aitable-mcp-server"
      ],
      "env": {
        "AITABLE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

デバッグ

MCP inspectorは、MCPサーバーのテストとデバッグに使用する開発者向けツールです。

MCPサーバーの実装を検査するために、MCP inspectorのリポジトリをクローンする必要はありません。代わりにnpxを使用します。たとえば、AITable MCPサーバーはdist/index.jsにビルドされています。引数はサーバーに直接渡され、環境変数は-eフラグを使って設定できます。

npx @modelcontextprotocol/inspector -e AITABLE_API_KEY={YOUR_API_KEY} node build/index.js

もう1つの方法は、MCP inspectorのリポジトリをクローンし、インスペクターのインターフェースでAITable MCPサーバーに接続することです。

cd path/to/inspector/
npm start -- -e AITABLE_API_KEY={YOUR_API_KEY}