MCP Bauplan

🚀 mcp-bauplan

minimalistなモデルコンテキストプロトコル（MCP）サーバーで、データテーブルとのやり取りやBauplanクエリの実行に使用します。

Bauplanは、S3におけるIcebergテーブルのデータストレージを、設定されたnamespace内で管理します。

✨ 主な機能

• 設定されたnamespace内のすべてのBauplanデータテーブルとそのスキーマを取得します。
• SQL（SELECTのみ）を使用して、指定されたテーブル上でクエリを実行します。

SSEとSTDIOの2種類の伝送方式をサポートしています。

🛠️ ツール

このサーバーは、Bauplanデータテーブルとのやり取りのために以下のツールを実装しています。

• list_tables:
  • 設定されたnamespace内のすべてのテーブルを一覧表示します。
• get_schema:
  • 指定されたデータテーブルのスキーマを取得します。
• run_query:
  • 指定されたテーブル上でSELECTクエリを実行します。

📦 インストール

設定

1. Claudeデスクトップの設定ファイルを作成または編集します。場所は以下の通りです。

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%/Claude/claude_desktop_config.json

2. 以下の内容を追加します。

{
  "mcpServers": {
    "mcp-bauplan": {
      "command": "/path/to/uvx",
      "args": ["mcp-bauplan"],
      "env": {
        "BAUPLAN_API_KEY": "your-api-key",
        "BAUPLAN_BRANCH": "your-branch",
        "BAUPLAN_NAMESPACE": "your-namespace",
        // オプション
        "BAUPLAN_TIMEOUT": "query-timeout-secs" // デフォルト30秒
      }
    }
  }
}

3. /path/to/uvxをuvx実行ファイルの絶対パスに置き換えます。ターミナルでwhich uvxコマンドを使用してパスを見つけます。これにより、サーバー起動時に正しいuvxバージョンが使用されます。

4. Claudeデスクトップを再起動して変更を適用します。

独立したSSEサーバーの実行

.env.exampleから.envファイルを作成し、以下のコマンドを実行します。

$ uvx --env-file /path/to/.env mcp-bauplan --transport sse --port 9090

注意：uvxの代わりにnvxを使用すると、デフォルトのリポジトリhttps://pypi.orgからmcp-bauplanを取得します。

🔨 開発

セットアップ

1. 前提条件：

   • Python 3.10以上。
   • Bauplan APIキー（こちらからリクエスト）。
   • uvパッケージマネージャー（インストール）。

2. リポジトリをクローン：

git clone https://github.com/marcoeg/mcp-bauplan
cd mcp-nvd

3. 環境変数を設定：
   • プロジェクトのルートディレクトリに.envファイルを作成します。

BAUPLAN_API_KEY=your-api-key
BAUPLAN_BRANCH=your-branch
BAUPLAN_NAMESPACE=your-namespace

4. 依存関係をインストール：

uv sync
uv pip install -e .

MCP Inspectorを使用して実行

cd /path/to/the/repo
source .env

CLIENT_PORT=8077 SERVER_PORT=8078 npx @modelcontextprotocol/inspector \
     uv run mcp-bauplan

注意：標準ポートが衝突しない場合は、CLIENT_PORT=8077 SERVER_PORT=8078を省略してください。

その後、ブラウザで指示されたURLを開きます。通常はhttp://localhost:8077?proxyPort=8078です。

inspectorでは、stdioとsseの伝送タイプを自由に切り替えることができます。sseを使用するには、以下の説明に従ってサーバーを実行してください。

SSE伝送を使用したテスト

サーバーを実行

cd /path/to/the/repo
source .env

uv run mcp-bauplan --transport sse --port 9090

• デフォルトでは、ポート9090でSSE伝送を使用して実行されます。

その後、ブラウザで指示されたURLを開き、SSE伝送タイプを選択します。