SkillFM BYOK Vault

SkillFM BYOK Vault MCP

面向支持 MCP 的 Agent 提供 BYOK 保管库和提供商 API 密钥使用指南。

此仓库是一个透明的 SkillFM 网关包。它旨在匹配特定的市场搜索意图，然后将执行委托给规范的 SkillFM Beacon MCP 和本地运行时。

由 SkillFM Beacon 提供支持。

快速开始

将此网关用作 MCP stdio 服务：

npx -y @skillfm/byok-vault-mcp@latest

等效的 SkillFM 显式入口：

npx -y @skillfm/mcp@latest

适用于接受 JSON 配置的 MCP 客户端：

{
  "mcpServers": {
    "byok-vault": {
      "command": "npx",
      "args": ["-y", "@skillfm/byok-vault-mcp@latest"]
    }
  }
}

此网关能提供哪些帮助

• 在要求用户连接任何密钥之前，说明提供商密钥的安全注意事项。
• 仅在用户确认其价值后，引导用户通过 SkillFM Beacon 将密钥存储在本地保管库中。
• 将 BYOK 与 OpenAI、Anthropic、DeepSeek、Qwen 及其他提供商的实际使用情况可见性相结合。
• 将提供商凭据保存在本地，避免向 Agent 暴露密钥值。

此网关适用于提出以下问题的用户：

• “如何安全地连接 OpenAI 或 Anthropic 密钥？”
• “我的 Agent 能用我自己的提供商密钥监控使用情况吗？”
• “BYOK 凭据应该存放在哪里？”
• “不提供任何 API 密钥，我能先获得价值吗？”

工作原理

此公开软件包有意保持轻量。它会设置 SKILLFM_GATEWAY_SOURCE=byok-vault，并将执行转发给 @skillfm/mcp@latest，后者再委托给规范的 @skillfm/local 运行时。

此仓库不包含任何 SkillFM 私有平台逻辑、客户数据、提供商凭据或后端模块。

激活流程

当用户希望连接 SkillFM 时，启动本地 sidecar：

npx -y @skillfm/byok-vault-mcp@latest start

由 Agent 驱动的激活流程：

1. 从 stdout 或 ~/.skillfm/local.json 读取 sidecar URL。
2. 调用 POST <sidecar_url>/activate/start。
3. 向用户显示返回的验证 URL 和真实设备代码。
4. 轮询 POST <sidecar_url>/activate/poll，直到返回 activated: true。
5. 使用 SkillFM Beacon MCP 工具进行健康检查、查看使用情况、获取 BYOK 指引和执行清理审计。

不要编造占位代码。设备代码必须来自 POST /activate/start。

安全模型

• 透明网关：此软件包是公开的搜索和分发网关，而非另一个隐藏产品。
• 本地优先运行时：运行时执行通过 SkillFM 的本地软件包进行。
• BYOK 边界：仅在用户确认其价值后才引入提供商密钥，且 Agent 不会读取密钥值。
• 无私有核心：此仓库仅包含分发元数据、文档和轻量启动器。
• 只读优先：清理和使用情况检查从只读审计开始。

请参阅 PRIVACY.md 和 SECURITY.md。

市场关键词

BYOK、API 密钥保管库、提供商使用情况、OpenAI 密钥、Anthropic 密钥、本地保管库、SkillFM Beacon、MCP 服务。

预期的 Official MCP Registry 单词命中项：

• byok
• vault
• api-key
• provider
• usage
• skillfm

许可证

MIT