BIGHUB

@bighub/bighub-mcp

BIGHUB の Better Decision レイヤーを MCP サーバーとして提供します。MCP 対応クライアントから実行する前に、提案された IT エージェントのアクションをより良い意思決定につなげます。

IT エージェントのアクションについて、より良い意思決定を支援する MCP サーバーです。

MCP client
   ↓
@bighub/bighub-mcp
   ↓
BIGHUB API
   ↓
proposed action → Decision Packet → DecisionBrain → decision signals → run / review / context / block

---

目次

まずはこちら

• インストール
• クイックスタート
• bighub-mcp を使う場面
• 一般的な MCP ループ
• Better Decision の基本要素
• 軌跡を考慮した評価

ツールリファレンス

• Better Decision の基本要素 · コアループ · アクション · 結果 · 意思決定ケース · 先例 · キャリブレーション · 複数シグナル検索 · インサイト · シミュレーション · 学習 · 機能 · 実行時の取り込み · システム連携 · 運用上の制約 · 承認とキルスイッチ · イベント · Webhook · API キー · 認証 · ユーティリティ

リファレンス

• 環境変数 · ローカル開発 · リンク

---

インストール

npm install @bighub/bighub-mcp

Node.js 18 以降が必要です。

---

クイックスタート

API キーを設定します。

export BIGHUB_API_KEY=your_api_key

stdio モードでサーバーを実行します。

npx @bighub/bighub-mcp

MCP クライアントの設定に追加します。

{
  "mcpServers": {
    "bighub": {
      "command": "npx",
      "args": ["@bighub/bighub-mcp"],
      "env": {
        "BIGHUB_API_KEY": "your_api_key"
      }
    }
  }
}

Claude Desktop や Cursor などの MCP 対応クライアントで動作します。

---

bighub-mcp を使う場面

MCP に接続されたエージェントが、次のような IT アクションを提案する場合に、このサーバーを使用します。

• Okta のアクセス権を付与する
• 認証情報をローテーションする
• サービスをデプロイまたはロールバックする
• CI/CD、クラウド、IAM の設定を変更する
• 機密データをエクスポートする
• インシデントやサポートに関する更新を投稿する
• 人による確認が必要なアクションを解決する

エージェントが質問への回答や読み取り専用の検索だけを行う場合は、必要ありません。実世界に影響を及ぼす意思決定を行うエージェント向けに設計されています。

---

一般的な MCP ループ

1. 提案された IT アクションを bighub_decide に送信します
2. BIGHUB に Decision Packet を構築または使用させます
3. DecisionBrain を実行し、実行モード、レビュー／コンテキストのフラグ、および利用可能な場合は意思決定経路を返します
4. can_run が true で、ブロックするフラグが設定されていない場合にのみ実行します
5. BIGHUB が人による承認または修正を求めた場合は、レビューに回します
6. 必要に応じて、後から結果を報告します

bighub_decide
→ bighub_build_packet / bighub_run_brain
→ bighub_resolve_review when needed
→ bighub_report_outcome later, optional

---

Better Decision の基本要素

最新の MCP インターフェースは、意思決定フローを中心に構成されています。

フィールド	説明
bighub_decide	提案された IT アクションを、より良い意思決定につなげます
bighub_build_packet	アクションとコンテキストから Decision Packet を構築します
bighub_run_brain	パケットに対して DecisionBrain を実行します
bighub_list_reviews	保留中のレビューを一覧表示します
bighub_resolve_review	レビュー対象のアクションを承認、拒否、または修正します
bighub_get_system_context	Okta、Slack、または設定済みの連携プロバイダーのコンテキストを取得します
bighub_get_world_state	運用上のワールドステートを読み取ります
bighub_report_outcome	後から任意で発生したことを報告します
bighub_http_request	まだモデル化されていないエンドポイント向けの低レベルなフォールバックです

bighub_decide と bighub_run_brain は、まず正規化された意思決定オブジェクトを返します。 recommended_action、mode、can_run、needs_review、needs_more_context、 should_not_run、risk、confidence、expected_regret、reason、system、 利用可能な場合は selected_model と decision_path、さらに検証ステップと 義務の件数が含まれます。高度な呼び出し元向けに、元のバックエンドペイロードも 引き続き raw から利用できます。互換性のため、bighub_actions_evaluate などの レガシーツールも引き続き使用できます。

bighub_build_packet は Python SDK と同じ正規 JSON SHA-256 ハッシュ方式を 使用するため、SDK クライアントと MCP クライアント間でパケットハッシュが一致します。

---

軌跡を考慮した評価

BIGHUB はアクションを単独で評価するだけでなく、それ以前に何が起きたかという文脈も考慮します。デプロイ、レビュー、結果の履歴が蓄積されるにつれて、類似する IT アクションに対する推奨の精度が向上します。

---

ツールの完全なリファレンス

BIGHUB のツールはドメイン別に整理されています。最初にコアループのツールを記載しています。

---

コアループ

ツール	説明
bighub_decide	最新の Better Decision エントリーポイント
bighub_build_packet	Decision Packet を構築
bighub_run_brain	DecisionBrain を実行
bighub_report_outcome	後から起きたことを任意で報告
bighub_actions_evaluate	レガシー／低レベルのアクション評価

---

アクション

ツール	説明
bighub_actions_evaluate	レガシー／低レベルのアクション評価
bighub_actions_evaluate_payload	自由形式のペイロードで評価
bighub_actions_evaluate_batch	1 回のリクエストで複数のアクションを評価
bighub_actions_dry_run	永続化しない評価（プレビュー）
bighub_actions_live_connect	ライブ接続スロットを開く
bighub_actions_live_heartbeat	ライブ接続のハートビートを送信
bighub_actions_live_disconnect	ライブ接続を閉じる
bighub_actions_verify_validation	検証ハッシュを確認
bighub_actions_observer_stats	オブザーバーの統計情報
bighub_actions_dashboard_summary	ダッシュボードの概要指標
bighub_actions_status	サービスのステータス
bighub_actions_memory_ingest	意思決定メモリーのイベントを取り込む
bighub_actions_memory_context	メモリーのコンテキストを取得
bighub_actions_memory_refresh_aggregates	メモリーの集計情報を更新
bighub_actions_memory_recommendations	メモリーに基づくパターンベースの推奨

---

結果

ツール	説明
bighub_outcomes_report	実環境での結果を報告
bighub_outcomes_report_batch	結果を一括報告
bighub_outcomes_get	request_id で結果を取得
bighub_outcomes_get_by_validation	validation_id で結果を取得
bighub_outcomes_get_by_case	case_id で結果を取得
bighub_outcomes_timeline	結果の全タイムライン
bighub_outcomes_pending	結果の報告待ちの意思決定
bighub_outcomes_analytics	結果の分析概要
bighub_outcomes_taxonomy	対応している結果ステータス
bighub_outcomes_recommendation_quality	ドメイン／アクター別の追従率、象限、推移
bighub_outcomes_partner_view	KPI と事例を含む、自己完結型のドメインビュー

---

意思決定ケース

ツール	説明
bighub_cases_create	意思決定ケースを作成
bighub_cases_get	ID でケースを取得
bighub_cases_list	ケースを一覧表示して絞り込む
bighub_cases_report_outcome	ケースの結果を報告
bighub_cases_precedents	提案されたアクションの先例情報
bighub_cases_calibration	ケースのキャリブレーション指標

---

先例

ツール	説明
bighub_precedents_query	過去の類似ケースを検索
bighub_precedents_signals	集計された先例シグナル
bighub_precedents_stats	先例インデックスの統計情報

---

キャリブレーション

ツール	説明
bighub_calibration_report	キャリブレーションレポート
bighub_calibration_reliability	信頼性ダイアグラムのデータ
bighub_calibration_drift	時間経過に伴うキャリブレーションのドリフト
bighub_calibration_breakdown	ドメインまたはツール別の内訳
bighub_calibration_feedback	キャリブレーションのフィードバックシグナル
bighub_calibration_observe	キャリブレーション観測を送信
bighub_calibration_quality_history	時間経過に伴う日次品質スコア

---

マルチシグナル検索

ツール	説明
bighub_retrieval_query	マルチシグナルによる類似事例検索
bighub_retrieval_query_explained	説明トレース付きの検索
bighub_retrieval_strategies	利用可能な戦略の一覧
bighub_retrieval_strategy	1つの戦略の詳細を取得
bighub_retrieval_index_case	事例を手動でインデックス化
bighub_retrieval_compare	2つの戦略を比較
bighub_retrieval_stats	検索インデックスの統計情報

---

インサイト

ツール	説明
bighub_insights_advise	アクションに関する学習済みアドバイス
bighub_insights_patterns	発見されたリスクパターン
bighub_insights_learn	学習の更新
bighub_insights_profile	アクション／ツールのプロファイル

---

シミュレーション

ツール	説明
bighub_simulations_list	シミュレーションスナップショットの一覧
bighub_simulations_get	スナップショットを取得
bighub_simulations_by_request	リクエストからスナップショットを取得
bighub_simulations_compare	予測と実績を比較
bighub_simulations_accuracy	ドメインレベルの精度
bighub_simulations_stats	シミュレーションの統計情報

---

学習

ツール	説明
bighub_learning_strategy	現在の学習戦略
bighub_learning_runs	最近の学習実行
bighub_learning_recompute	学習の再計算を実行
bighub_learning_backfill	学習成果物をバックフィル

---

特徴量

ツール	説明
bighub_features_compute	アクションの特徴量を計算
bighub_features_compute_batch	特徴量の一括計算
bighub_features_snapshot	特徴量スナップショットを作成
bighub_features_get_snapshot	スナップショットを取得
bighub_features_list_snapshots	スナップショットの一覧
bighub_features_explain	事例の特徴量を説明
bighub_features_export	事例の特徴量をエクスポート
bighub_features_export_batch	一括エクスポート
bighub_features_compare	特徴量セットを比較
bighub_features_schema	特徴量スキーマ
bighub_features_stats	特徴量の統計情報

---

ランタイム取り込み

ツール	説明
bighub_ingest_event	単一のイベントを取り込む
bighub_ingest_batch	イベントを一括で取り込む
bighub_ingest_reconcile	イベントと結果を照合
bighub_ingest_lifecycles	イベントのライフサイクル一覧
bighub_ingest_lifecycle	1つのイベントのライフサイクルを取得
bighub_ingest_pending	照合待ちのイベント
bighub_ingest_stale	照合されていない古いイベント
bighub_ingest_stats	取り込みの統計情報
bighub_ingest_adapters	利用可能なアダプターの一覧

---

システム連携

ツール	説明
bighub_systems_list_connections	設定済みのシステム連携を一覧表示します
bighub_systems_get_connection	プロバイダー接続の概要を取得します
bighub_systems_test_connection	保存前のプロバイダー設定をテストします
bighub_systems_save_connection	任意の display_name を指定してプロバイダー設定を保存します
bighub_systems_delete_connection	プロバイダー接続を削除します
bighub_systems_poll_now	プロバイダーのポーリングを今すぐ1回実行します
bighub_systems_get_poll_schedule	プロバイダーのポーリングスケジュールを取得します
bighub_systems_update_poll_schedule	プロバイダーのポーリングを設定します
bighub_systems_poll_history	マスキング済みのプロバイダーのポーリング履歴を読み取ります
bighub_systems_poll_status	スケジューラーの状態と期限到来件数を取得します
bighub_systems_poll_metrics	プロバイダーの成功／失敗、レイテンシー、古いスケジュール、および検証メトリクスを取得します
bighub_systems_run_due_polls	現在の組織の期限到来済みポーリングを実行します

サポート対象のシステムプロバイダーには、okta、slack、github、sentry、datadog、aws_cloudtrail、terraform、kubernetes、argocd、gitlab、jenkins、azure、prometheus、grafana、openshift が含まれます。github-ci、cloudtrail、terraform-cloud、k8s、argo-cd、gitlab-ci、ocp などの一般的なエイリアスは、バックエンドのプロバイダー ID に正規化されます。

ポーリングのスナップショットと履歴は、永続化および公開の前にマスキングされます。これらは運用状況の把握に役立つ範囲でコンテキストを提供しますが、本番環境のモニタリングに代わるものではありません。

---

運用上の制約

ツール	説明
bighub_constraints_create	制約を作成します
bighub_constraints_list	制約を一覧表示します
bighub_constraints_get	制約を取得します
bighub_constraints_update	制約を更新します
bighub_constraints_delete	制約を削除します
bighub_constraints_pause	制約を一時停止します
bighub_constraints_resume	制約を再開します
bighub_constraints_dry_run	永続化せずにプレビューします
bighub_constraints_validate	制約に照らしてアクションを検証します
bighub_constraints_validate_dry_run	検証します（ドライラン）
bighub_constraints_domains	制約が設定されたドメインを一覧表示します
bighub_constraints_versions	制約のバージョン履歴を表示します
bighub_constraints_apply_patch	JSON Patch を適用します
bighub_constraints_purge_idempotency	管理者：冪等性キーを消去します

---

承認とキルスイッチ

ツール	説明
bighub_approvals_list	承認リクエストを一覧表示します
bighub_approvals_resolve	承認を処理します
bighub_kill_switch_status	キルスイッチの状態を取得します
bighub_kill_switch_activate	キルスイッチを有効にします
bighub_kill_switch_deactivate	キルスイッチを無効にします

---

イベント

ツール	説明
bighub_events_list	イベントストリームをクエリします
bighub_events_stats	イベント統計を取得します

---

Webhook

ツール	説明
bighub_webhooks_create	Webhook を作成します
bighub_webhooks_list	Webhook を一覧表示します
bighub_webhooks_get	Webhook を取得します
bighub_webhooks_update	Webhook を更新します
bighub_webhooks_delete	Webhook を削除します
bighub_webhooks_deliveries	配信を一覧表示します
bighub_webhooks_test	テスト配信を送信します
bighub_webhooks_list_events	購読可能なイベントタイプを一覧表示します
bighub_webhooks_verify_signature	Webhook の署名を検証します
bighub_webhooks_replay_failed_delivery	失敗した配信を再実行します

---

API キー

ツール	説明
bighub_api_keys_create	API キーを作成します
bighub_api_keys_list	API キーを一覧表示します
bighub_api_keys_delete	API キーを削除します
bighub_api_keys_rotate	API キーをローテーションします
bighub_api_keys_validate	API キーを検証します
bighub_api_keys_scopes	利用可能なスコープを一覧表示します

---

Auth

Tool	Description
bighub_auth_signup	Create an account
bighub_auth_login	Log in
bighub_auth_refresh	Refresh token
bighub_auth_logout	Log out

---

Utility

Tool	Description
bighub_http_request	Generic HTTP passthrough

---

Environment Variables

Variable	Required	Default	Description
BIGHUB_API_KEY	Yes*	-	API key auth
BIGHUB_BEARER_TOKEN	No	-	Alternative bearer auth
BIGHUB_BASE_URL	No	https://api.bighub.io	API base URL
BIGHUB_TIMEOUT_MS	No	15000	Request timeout
BIGHUB_MAX_RETRIES	No	2	Retries on transient failures
BIGHUB_ALLOW_INSECURE_HTTP	No	-	Allow HTTP for local/private testing

* One of BIGHUB_API_KEY or BIGHUB_BEARER_TOKEN is required.

Management tools (API keys, webhooks, auth) require user JWT auth via BIGHUB_BEARER_TOKEN.

---

Local Development

git clone https://github.com/bighub-io/bighub.git
cd bighub/servers/mcp
npm install
npm run test
npm run check
npm run build
npm run start
npm run dev

---

Links

• bighub.io
• GitHub - bighub-io/bighub
• npm - @bighub/bighub-mcp
• PyPI - bighub (Python SDK)
• PyPI - bighub-openai

---

License

Apache-2.0