SkillFM Beacon

SkillFM Beacon MCP

为支持 MCP 的 Agent 提供 AI 健康检查、Token 用量、成本优化、BYOK 监控和安全清理功能。

SkillFM Beacon 为 Claude Code、Cursor、Cline、Claude Desktop、VS Code Copilot 和其他 MCP 客户端提供实用的 AI 运维层：

• 检查 AI 健康状况和会话状态。
• 查看 Token 用量和大模型支出。
• 从服务商设置、缓存使用、批处理和上下文清理等方面寻找节省成本的机会。
• 使用存储在本地保险库中的 BYOK 密钥监控服务商账单。
• 检查导致 Agent 变慢的杂项，例如过时的 worktree、过大的日志和臃肿的上下文。
• 随着内容、社交媒体、电子商务、SEO/GEO 和工作流自动化相关 Skill 上线，发现未来的 SkillFM Skill。

此仓库是 SkillFM MCP 市场条目的公开分发外壳。规范的本地运行时是 @skillfm/local。

快速开始

将 SkillFM Beacon 用作 MCP stdio 服务：

npx -y @skillfm/mcp@latest

等效的显式形式：

npx -y @skillfm/mcp@latest mcp

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

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

激活流程

MCP 包会委托给 @skillfm/local@latest，因此同一个包可以启动本地 sidecar，并在当前机器上激活 SkillFM。

启动本地 sidecar：

npx -y @skillfm/mcp@latest start

sidecar 仅绑定到 127.0.0.1，并将服务发现文件写入：

~/.skillfm/local.json

由 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. 使用 GET <sidecar_url>/status、GET <sidecar_url>/skills 或 MCP 工具。

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

常用命令

# Start MCP stdio server
npx -y @skillfm/mcp@latest

# Start local sidecar for current-chat activation
npx -y @skillfm/mcp@latest start

# Show AI health checkup from the CLI
npx -y @skillfm/mcp@latest checkup

# Detect supported local agent harnesses
npx -y @skillfm/mcp@latest safe detect

# Install local SkillFM guidance into supported local agents after user approval
npx -y @skillfm/mcp@latest safe inject

# Remove injected local guidance
npx -y @skillfm/mcp@latest safe uninstall

SkillFM 可提供的帮助

SkillFM Beacon 面向有以下需求的用户：

• “我今天用了多少 Token？”
• “为什么我的 AI 账单越来越高？”
• “我能否降低 OpenAI、Anthropic、DeepSeek、Qwen 或其他大模型服务商的费用？”
• “上下文或工作区过于臃肿，导致我的 Agent 变慢了吗？”
• “如何安全地连接服务商密钥，而不将其发送到 SaaS 控制面板？”
• “我的 AI 可以运行哪些 Skill 来处理内容、电子商务、社交媒体、SEO/GEO 或自动化任务？”

安全模型

• 本地 sidecar：激活 sidecar 监听 127.0.0.1，而非公共网络。
• BYOK 保险库：服务商 API 密钥由 @skillfm/local 存储在本地；Agent 无法读取密钥值。
• 此仓库不包含私有核心：此仓库仅包含分发元数据和精简的启动器，不包含非公开的平台实现细节。
• 由用户控制的激活：OAuth 设备流激活需要用户在自己的浏览器中批准真实设备代码。
• 优先只读清理：清理审计旨在先报告导致 Agent 变慢的杂项，再执行任何由用户指示的清理操作。

有关公开仓库的边界，请参阅 PRIVACY.md 和 SECURITY.md。

市场关键词

SkillFM Beacon 的设计旨在便于用户通过以下关键词发现：

MCP server、AI health checkup、token usage、LLM spend、AI cost optimizer、BYOK、local vault、agent monitoring、slow agent cleanup、context cleanup、Claude Code、Cursor、Cline、Claude Desktop、VS Code Copilot、OpenAI usage、Anthropic usage、DeepSeek usage、Qwen usage。

公开内容边界

此公开包刻意保持精简。它旨在让用户能够从 MCP 市场和 Agent 目录轻松安装 SkillFM，同时将核心安全逻辑和平台逻辑保留为私有内容。

公开内容：

• MCP 注册表元数据
• npm 启动器包
• 安装文档
• 激活流程
• 安全模型
• 面向用户的工具说明

私有内容：

• 非公开的平台实现
• 专有评估内部机制
• 私有提示词或配置
• 客户数据或日志
• 服务商凭据

市场就绪情况

• server.json.name 与 package.json.mcpName 相匹配。
• npm 包是面向公众的精简启动器，供 @skillfm/local 使用。
• 对于作用域 npm 发布，publishConfig.access 设置为 public。
• 公开文档不会声称收入有保证、可以获得被动收入或能够自动赚钱。
• 仓库不包含后端服务代码、客户日志、服务提供商密钥或非公开自动化逻辑。

在提交到 MCP 注册表或 Agent 目录之前，请参阅 docs/MARKETPLACE-CHECKLIST.md。

许可证

MIT