SkillFM Beacon

Saúde de IA, uso de tokens, otimização de custos de LLM, cofre BYOK e auditorias de limpeza para agentes MCP.

GitHubExperimente este MCPPatrocinado

Documentação

SkillFM Beacon MCP

Saúde de IA, uso de tokens, otimização de custos, monitoramento BYOK e limpeza segura para agentes compatíveis com MCP.

O SkillFM Beacon fornece ao Claude Code, Cursor, Cline, Claude Desktop, VS Code Copilot e outros clientes MCP uma camada prática de operações de IA:

  • Verifique a saúde da IA e o status da sessão.
  • Inspecione o uso de tokens e os gastos com LLM.
  • Encontre oportunidades de economia em configuração de provedores, uso de cache, processamento em lote e limpeza de contexto.
  • Monitore a cobrança dos provedores com chaves BYOK armazenadas em um cofre local.
  • Audite a desorganização que deixa agentes lentos, como worktrees obsoletos, logs superdimensionados e contexto inchado.
  • Descubra futuras skills do SkillFM para conteúdo, mídias sociais, e-commerce, SEO/GEO e automação de fluxos de trabalho à medida que forem disponibilizadas.

Este repositório é o shell de distribuição pública da listagem do SkillFM no marketplace MCP. O runtime local canônico é @skillfm/local.

Início Rápido

Use o SkillFM Beacon como um servidor MCP stdio:

npx -y @skillfm/mcp@latest

Forma explícita equivalente:

npx -y @skillfm/mcp@latest mcp

Para clientes MCP que aceitam configuração JSON:

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

Caminho de Ativação

O pacote MCP delega para @skillfm/local@latest, para que o mesmo pacote possa iniciar o sidecar local e ativar o SkillFM na máquina atual.

Inicie o sidecar local:

npx -y @skillfm/mcp@latest start

O sidecar vincula-se apenas a 127.0.0.1 e grava seu arquivo de descoberta de serviço em:

~/.skillfm/local.json

Fluxo de ativação conduzido pelo agente:

  1. Leia a URL do sidecar na saída padrão ou em ~/.skillfm/local.json.
  2. Chame POST <sidecar_url>/activate/start.
  3. Mostre a URL de verificação retornada e o código de dispositivo real ao usuário.
  4. Consulte POST <sidecar_url>/activate/poll até que ele retorne activated: true.
  5. Use GET <sidecar_url>/status, GET <sidecar_url>/skills ou as ferramentas MCP.

Não invente um código de espaço reservado. O código de dispositivo deve vir de POST /activate/start.

Comandos Úteis

# 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

Com o Que o SkillFM Ajuda

O SkillFM Beacon é para usuários que perguntam:

  • "Quantos tokens usei hoje?"
  • "Por que minha conta de IA está aumentando?"
  • "Posso economizar dinheiro com OpenAI, Anthropic, DeepSeek, Qwen ou outros provedores de LLM?"
  • "Meu agente está ficando lento porque o contexto ou o espaço de trabalho está inchado?"
  • "Como conecto com segurança uma chave de provedor sem enviá-la a um painel SaaS?"
  • "Que skills minha IA pode executar para conteúdo, e-commerce, mídias sociais, SEO/GEO ou automação?"

Modelo de Segurança

  • Sidecar local: O sidecar de ativação escuta em 127.0.0.1, não na rede pública.
  • Cofre BYOK: As chaves de API dos provedores são armazenadas localmente por @skillfm/local; os agentes não leem os valores das chaves de volta.
  • Sem núcleo privado neste repositório: Este repositório contém apenas metadados de distribuição e um launcher enxuto. Detalhes de implementação da plataforma não públicos não estão incluídos.
  • Ativação controlada pelo usuário: A ativação por fluxo de dispositivo OAuth exige que o usuário aprove o código de dispositivo real no próprio navegador.
  • Limpeza somente leitura primeiro: As auditorias de limpeza são projetadas para relatar a desorganização que deixa agentes lentos antes de qualquer ação de limpeza direcionada pelo usuário.

Consulte PRIVACY.md e SECURITY.md para conhecer o limite do repositório público.

Palavras-chave do Marketplace

O SkillFM Beacon foi projetado para ser encontrado por:

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.

Limite da Superfície Pública

Este pacote público é intencionalmente pequeno. Ele existe para facilitar a instalação do SkillFM a partir de marketplaces MCP e diretórios de agentes, mantendo a segurança essencial e a lógica da plataforma privadas.

Público:

  • Metadados do registro MCP
  • Pacote launcher npm
  • Documentação de instalação
  • Fluxo de ativação
  • Modelo de segurança
  • Descrições de ferramentas voltadas ao usuário

Privado:

  • Implementação de plataforma não pública
  • Internos de avaliação proprietários
  • Prompts ou configurações privadas
  • Dados ou logs de clientes
  • Credenciais de provedores

Prontidão para o Marketplace

  • server.json.name corresponde a package.json.mcpName.
  • O pacote npm é um launcher público enxuto para @skillfm/local.
  • publishConfig.access está definido como public para publicação npm com escopo.
  • A documentação pública evita alegações de renda garantida, renda passiva e ganhos automáticos.
  • O repositório não contém código de serviço de backend, logs de clientes, chaves de provedores ou lógica de automação não pública.

Consulte docs/MARKETPLACE-CHECKLIST.md antes de enviar para registros MCP ou diretórios de agentes.

Licença

MIT