Holster MCP

Holster MCP

Holster MCP 向兼容 MCP 的 Agent 提供本地 Holster Doctor 检查。该服务以本地为先：免费工具会调用随附的 holster-doctor 二进制文件，绝不会将代码库内容发送到网络服务。

安装

从 PyPI 安装：

pip install holster-mcp

开发环境安装：

cd /path/to/holster/mcp
python3.11 -m pip install -e '.[dev]'

运行命令：

holster-mcp

MCP 客户端配置：

{
  "mcpServers": {
    "holster": {
      "command": "uvx",
      "args": ["holster-mcp"]
    }
  }
}

如需安装 vault 和 holster-cli 发布版二进制文件，请参阅 Holster 主 README。

MCP 软件包采用 MIT 许可证。

二进制文件解析

服务按以下顺序查找 holster-doctor：

1. HOLSTER_DOCTOR_BIN
2. 打包在 wheel 中的二进制文件 holster_mcp/bin/holster-doctor
3. PATH 中的 holster-doctor
4. 代码库本地的 target/release/holster-doctor
5. 代码库本地的 target/debug/holster-doctor

免费工具

holster.scan_repo

输入：

{"path": "/absolute/repo/path", "depth": 3}

输出：

{
  "ok": true,
  "scanned_files": 15,
  "findings": [
    {
      "file": "src/main.py",
      "line": 12,
      "secret_kind": "openai_api_key",
      "severity": "error",
      "suggestion": "Rotate this key and move it into a local vault."
    }
  ]
}

holster.check_gitignore

输入：

{"path": "/absolute/repo/path"}

输出：

{
  "ok": true,
  "missing_patterns": [".env.local"],
  "existing_safe": [".env"],
  "existing_unsafe": [],
  "suggested_append": ".env.local\n*.pem"
}

holster.rotation_playbook

输入：

{"provider": "github"}

输出：

{
  "ok": true,
  "provider": "github",
  "steps": ["Create a replacement token...", "Update local consumers...", "Revoke the old token..."],
  "estimated_minutes": 15,
  "warnings": ["Do not revoke the old credential until the replacement has been verified."]
}

平台 Wheel

首日构建的 wheel 适用于：

• macOS ARM（aarch64-apple-darwin）
• Linux x86_64（x86_64-unknown-linux-gnu）

这些 wheel 包含对应平台的 holster-doctor 二进制文件，且有意不构建为通用版本。

付费工具

付费工具是围绕 holster-cli 的本地专用封装，并受 Holster 许可证限制。

许可证配置

许可证查找顺序：

1. 传递给付费 MCP 工具的 license_key 参数
2. HOLSTER_LICENSE_KEY
3. ~/.holster/config.toml

支持以下 config.toml 格式：

license_key = "holster_live_ABCDEFGHIJKLMNOPQRSTUVWX"
vault_path = "/absolute/path/to/holster-vault.db"

或：

[license]
key = "holster_live_ABCDEFGHIJKLMNOPQRSTUVWX"

[vault]
path = "/absolute/path/to/holster-vault.db"

许可证缓存：

~/.holster/licenses.db

如果未配置许可证，首次调用付费工具时会创建一个有效期为 7 天、前缀为 holster_trial_ 的本地试用密钥。

Vault 配置

Vault 路径查找顺序：

1. 支持时使用显式工具参数
2. HOLSTER_VAULT_PATH
3. ~/.holster/config.toml

holster.vault_add

输入：

{
  "provider": "github",
  "account": "nauta-ai",
  "secret": "user-pasted-secret",
  "label": "primary"
}

输出：

{"ok": true, "vault_entry_id": "123e4567-e89b-12d3-a456-426614174000", "error": null}

机密值绝不会放入 CLI 参数、日志或结构化错误输出中。

holster.vault_rotate

第 2 天支持 github 和 stripe。

如果未提供 new_secret，工具会返回提供商操作手册，并等待人工轮换或粘贴替换值：

{
  "provider": "github",
  "account": "nauta-ai",
  "vault_entry_id": "old-id"
}

如果提供了 new_secret，替换值会添加到本地 vault；如果已安装的 CLI 支持相应命令，旧条目会标记为已取代。

holster.audit_log

输入：

{"provider": "github", "account": "nauta-ai", "since_days": 30}

输出：

{"ok": true, "events": [{"ts": "...", "action": "add", "provider": "github", "account": "nauta-ai", "ok": true}]}

许可证架构

flowchart TD
  A["Paid MCP tool call"] --> B["Resolve license key from arg/env/config"]
  B --> C{"Key present?"}
  C -- "No" --> D["Create local 7-day trial in ~/.holster/licenses.db"]
  C -- "Yes" --> E["Read ~/.holster/licenses.db"]
  D --> F{"Trial valid?"}
  E --> G{"Cached license valid?"}
  G -- "Valid" --> H["Dispatch paid tool"]
  G -- "Expired but within 7-day grace" --> I["Dispatch with license_warning"]
  G -- "Missing/stale live key" --> J["Stripe refresh: Customer.retrieve + Subscription.list"]
  J -- "Active" --> K["Update cache valid_until + last_checked"]
  J -- "Inactive/error/no API key" --> L["Return license_required_or_expired"]
  F -- "Valid" --> H
  F -- "Expired" --> L
  K --> H
  I --> H
  H --> M["Local holster-cli subprocess"]

付费工具完成验证后，后台轮询器每 10 分钟刷新一次缓存的有效许可证。第 2 天不提供 webhook 接收器，V1 不含遥测功能。