BIGHUB

@bighub/bighub-mcp

BIGHUB 的更优决策层，作为 MCP 服务运行。在任何兼容 MCP 的客户端中，让拟议的 IT Agent 操作在执行前先做出更优决策。

用于改进 IT Agent 操作决策的 MCP 服务。

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

---

目录

从这里开始

• 安装
• 快速入门
• 何时使用 bighub-mcp
• 典型 MCP 循环
• 更优决策基础组件
• 轨迹感知评估

工具参考

• 更优决策基础组件 · 核心循环 · 操作 · 结果 · 决策案例 · 先例 · 校准 · 多信号检索 · 洞察 · 模拟 · 学习 · 功能 · 运行时数据摄取 · 系统集成 · 运行约束 · 审批与紧急停止开关 · 事件 · 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 连接的 Agent 提出以下 IT 操作时，请使用此服务：

• 授予 Okta 访问权限
• 轮换凭据
• 部署或回滚服务
• 更改 CI/CD、云或 IAM 设置
• 导出敏感数据
• 发布事件或支持更新
• 处理需要人工审核的操作

如果你的 Agent 只回答问题或执行只读查询，则不需要此服务。它专为会做出具有现实影响的决策的 Agent 而设计。

---

典型 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

---

更优决策基础组件

现代 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	在一个请求中评估多个操作
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	获取某个策略的详细信息
bighub_retrieval_index_case	手动为案例建立索引
bighub_retrieval_compare	比较两种策略
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	获取某个事件的生命周期
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	立即触发一次提供方轮询
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