mcp-bauplan

mcp-bauplan

データテーブルを操作し、Bauplan のクエリを実行する、ミニマリストな Model Context Protocol MCP サーバーです。

Bauplan は、S3 上で Iceberg テーブルのデータストアを管理します。

機能

• 設定された名前空間内の Bauplan データテーブルとそのスキーマを取得します
• SQL を使用して Bauplan データテーブルをクエリします（SELECT のみ）

SSE と STDIO の両方のトランスポートに対応しています。

ツール

このサーバーには、Bauplan データテーブルを操作するための以下のツールが実装されています。

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

設定

1. 以下の場所にある Claude Desktop の設定ファイルを新規作成するか、編集します。

   • 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",
        // Optional
        "BAUPLAN_TIMEOUT": "query-timeout-secs" // default 30 seconds
      }
    }
  }
}

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

4. 変更を適用するため、Claude Desktop を再起動します。

スタンドアロンの SSE サーバーを実行する

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

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

uvx ではなく nvx を使用すると、デフォルトのレジストリ https://pypi.org から mcp-bauplan が取得される点に注意してください。

今後の開発

開発中

1. リソースとしての Bauplan（SDK と Platform）のドキュメント化
2. Bauplan 実行の自動化 — コマンドの追加とパイプラインの実行
3. クエリの生成
4. テンプレートを使用したコード生成
5. データガバナンスとコンプライアンス
6. テストと検証
7. 統合エコシステム

セットアップ

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 を省略してください。

次にブラウザーを開き、MCP Inspector に表示された 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

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

次にブラウザーを開き、MCP Inspector に表示された URL にアクセスします。SSE トランスポートタイプを選択してください。