WhiteBoxXAI

whiteboxxai-mcp

一个 MCP（模型上下文协议） 服务，可将 WhiteBoxXAI 的可观测性和可解释性能力提供给任何 兼容 MCP 的客户端（Claude Desktop、Claude Code、LangChain、自定义 Agent 框架等）， 包括模型注册表、基于 Git 的模型差异比较、预测日志记录、漂移检测、偏差／公平性审计、 ISO/IEC 42001 准备度和合规证据、AI 风险登记册／治理审查查询、提示词治理、 异步 SHAP/LIME 解释生成、大模型可解释性（注意力／令牌重要性／敏感性／反事实 分析和提示词调试）、大模型调用监控（令牌／成本／延迟跟踪）、RAG 流水线 监控、内容安全分析、警报规则和分诊上下文、警报智能、警报管理、多 Agent 工作流跟踪 以及模型性能指标（18 个领域共 197 种工具）。支持 MCP Apps（ui:// 资源），提供 沙盒化交互式审计卡片，并支持 stdio 传输和 Streamable HTTP 传输（托管于 https://api.whiteboxxai.com/mcp/）。

完整设置说明、连接示例、工具参考以及已知的 v1 限制，请参阅集成文档。可运行的 LangChain、Semantic Kernel 和原始 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/），请在 Authorization: Bearer <token> 请求头中传入 API 密钥或个人 JWT。

Agent 技能

若要让编码 Agent 完成设置并正确调用这些工具，请向它提供 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：这三个调用最多可能需要约 30 秒——后端会在响应前于服务端阻塞等待 Celery 任务完成，SDK 客户端也专门为这些调用使用了延长的（40 秒）超时时间。
• 范围：模型、预测、漂移、偏差/公平性、AI 风险登记册/治理查询、提示词、合规、解释、LLM 可解释性、LLM 调用监控、RAG 监控、内容安全、警报智能、警报管理、多 Agent 工作流和指标，均已覆盖 18 个领域（共 197 个工具），并通过 stdio 和托管的 Streamable HTTP 提供。

MCP 注册表

该服务已以 io.github.AgentaFlow/whiteboxxai-mcp 的名称发布至 官方 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 releases；请参阅 RELEASING.md。

许可证

MIT——请参阅 LICENSE。