Bitable MCP

🚀 可etable MCP サーバー

この MCP サーバーは、Model Context Protocol を通じて Lark Bitable へのアクセスを提供します。ユーザーは事前定義されたツールを使用して Bitable テーブルとやり取りすることができます。

🚀 クイックスタート

📦 インストール

Claude でのインストールと設定

サーバーをインストールして設定するには、以下のコマンドを使用します。

PERSONAL_BASE_TOKEN=your_personal_base_token APP_TOKEN=your_app_token uv run --with uv --with bitable-mcp bitable-mcp-install

your_personal_base_token と your_app_token を実際のトークンに置き換えてください。

Cursor でのインストール

近日公開予定です。

Windsurf でのインストール

近日公開予定です。

💻 使用例

利用可能なツール

• list_table - 現在の Bitable のテーブルを一覧表示します。

  • 戻り値：JSON 形式のテーブル名のリスト。

• describe_table - 名前でテーブルを説明します。

  • パラメータ：
    • name (str): 説明するテーブルの名前。
  • 戻り値：JSON 形式の列のリスト。

• read_query - SQL クエリを実行してテーブルからデータを読み取ります。

  • パラメータ：
    • sql (str): 実行する SQL クエリ。
  • 戻り値：JSON 形式のクエリ結果のリスト。

手動インストールと設定

uvx をインストールしてからインストールを行ってください。

Claude 設定の追加

1. uvx を使用する場合

"mcpServers": {
  "bitable-mcp": {
    "command": "uvx",
    "args": ["bitable-mcp"],
    "env": {
        "PERSONAL_BASE_TOKEN": "your-personal-base-token",
        "APP_TOKEN": "your-app-token"
    }
  }
}

2. pip を使用してインストールする場合

1. pip を使って bitable-mcp をインストールします。

pip install bitable-mcp

2. Claude 設定を変更します。

"mcpServers": {
  "bitable-mcp": {
    "command": "python",
    "args": ["-m", "bitable_mcp"],
    "env": {
        "PERSONAL_BASE_TOKEN": "your-personal-base-token",
        "APP_TOKEN": "your-app-token"
    }
  }
}

Zed の設定

Zed の settings.json に以下を追加します。

uvx を使用する場合

"context_servers": [
  "bitable-mcp": {
    "command": "uvx",
    "args": ["bitable-mcp"],
    "env": {
        "PERSONAL_BASE_TOKEN": "your-personal-base-token",
        "APP_TOKEN": "your-app-token"
    }
  }
],

pip を使用してインストールする場合

"context_servers": {
  "bitable-mcp": {
    "command": "python",
    "args": ["-m", "bitable_mcp"],
    "env": {
        "PERSONAL_BASE_TOKEN": "your-personal-base-token",
        "APP_TOKEN": "your-app-token"
    }
  }
},

デバッグ

MCP インスペクターを使用してサーバーをデバッグすることができます。uvx でインストールした場合：

npx @modelcontextprotocol/inspector uvx bitable-mcp