WhiteBoxXAI

whiteboxxai-mcp

WhiteBoxXAI の可観測性および説明可能性機能（モデルレジストリ、Git ベースのモデル差分比較、予測ログ記録、ドリフト検出、バイアス／公平性の監査、ISO/IEC 42001 への対応準備とコンプライアンス証跡、AI リスクレジスター／ガバナンスレビューのクエリ、プロンプトガバナンス、非同期の SHAP/LIME 説明生成、LLM の説明可能性（アテンション／トークン重要度／感度／反実仮想分析およびプロンプトのデバッグ）、LLM 呼び出しのモニタリング（トークン／コスト／レイテンシーの追跡）、RAG パイプラインのモニタリング、コンテンツ安全性分析、アラートルールとトリアージのコンテキスト、アラートインテリジェンス、アラート管理、マルチエージェントのワークフロー追跡、モデル性能指標（18 ドメインにわたる 197 個のツール））を、任意の MCP（Model Context Protocol） 対応クライアント（Claude Desktop、Claude Code、LangChain、カスタムエージェントハーネスなど）に公開する MCP サーバーです。サンドボックス化されたインタラクティブな監査カードを備えた MCP Apps（ui:// リソース）、stdio トランスポート、Streamable HTTP トランスポート（https://api.whiteboxxai.com/mcp/ でホスト）に対応しています。

完全なセットアップ方法、接続例、ツールリファレンス、既知の v1 の制限事項については、統合ドキュメントをご覧ください。実行可能な LangChain、Semantic Kernel、raw MCP クライアントの統合例については、examples/をご覧ください。

インストール

pip install whiteboxxai-mcp

実行（stdio — ローカル／セルフホスト）

環境変数で認証情報を設定してから、コンソールスクリプトを実行します。 stdio トランスポートでは WHITEBOXXAI_MCP_API_KEY を使用して認証します。

# An API key generated from the WhiteBoxXAI dashboard's Settings > API Keys tab.
# Never expires on a fixed schedule -- only when explicitly revoked -- and doesn't require storing a password.
export WHITEBOXXAI_MCP_API_BASE_URL="https://api.whiteboxxai.com"
export WHITEBOXXAI_MCP_API_KEY="wbx_live_..."

whiteboxxai-mcp

このコマンドを MCP クライアントに指定します（例：Claude Desktop の mcpServers 設定、または Claude Code の .mcp.json）。

ホスト型の Streamable HTTP（https://api.whiteboxxai.com/mcp/）では、API キーまたは個人用 JWT を Authorization: Bearer <token> ヘッダーに指定します。

エージェントスキル

コーディングエージェントにセットアップとツールの正しい呼び出しを行わせるには、whitebox-mcp-server スキル（および whitebox-governance-rules）を渡してください。これらは https://whiteboxxai.com/skills/index.md で公開されています。スキルが参照するツール一覧は tests/mcp_inspector_snapshot.json に固定されています。ツールの名前変更や削除は、ここに差分として表示されます。

バージョン管理とサポート

このパッケージはセマンティックバージョニングに従っています。リリース履歴については CHANGELOG.md をご覧ください。セルフホストの stdio 利用（上記）はベストエフォートでサポートされます。ホスト型の /mcp/ HTTP エンドポイントは製品機能であり、サポート／SLA は呼び出し元の基盤となる Free/Business Cloud プランに準じます。

v1 の既知の制限事項

• 認証：stdio では WHITEBOXXAI_MCP_API_KEY を使用します。これはスコープが限定され、無効化可能な認証情報であり、人間のアカウントのパスワードやセッションのライフサイクルには紐づいていません。 ホスト型 Streamable HTTP（https://api.whiteboxxai.com/mcp/）では、API キーまたは個人用 JWT を受け付けます。
• アラート：コアとなるアラートルールとトリアージのコンテキスト（whitebox_alerts_*）、アラートインテリジェンス（whitebox_alert_intelligence_*、20 個のツール）、アラート管理（whitebox_alert_management_*、13 個のツール）をカバーします。
• whitebox_agent_workflows_cost_breakdown／_bottlenecks／_timeline：これら 3 つのツールは、完了まで最大約 30 秒かかることがあります。バックエンドは応答前にサーバー側で Celery タスクの完了を待ちます。また、SDK クライアントはこれらの呼び出しに限り、タイムアウトを延長（40 秒）して使用します。
• 対象範囲：モデル、予測、ドリフト、バイアス／公平性、AI リスクレジスター／ガバナンスに関するクエリ、プロンプト、コンプライアンス、説明、LLM の説明可能性、LLM 呼び出しのモニタリング、RAG のモニタリング、コンテンツセーフティ、アラートインテリジェンス、アラート管理、マルチエージェントワークフロー、メトリクスを含む 18 のドメインにわたるすべての機能（合計 197 個のツール）が、stdio とホスト型 Streamable HTTP の両方で提供されます。

MCP Registry

このサーバーは、公式 MCP Registry に io.github.AgentaFlow/whiteboxxai-mcp として公開されています。

開発

pip install -e ".[dev]"
pytest tests/unit

# MCP Inspector tool-list regression check (needs Node.js); after an intentional
# tool change, regenerate the committed snapshot with --write
python tests/check_mcp_inspector_snapshot.py

リリースは GitHub リリースから作成されます。詳しくは RELEASING.md をご覧ください。

ライセンス

MIT -- LICENSE をご覧ください。