SkillFM Beacon
Salud de IA, uso de tokens, optimización de costos de LLM, bóveda BYOK y auditorías de limpieza para agentes MCP.
Documentación
SkillFM Beacon MCP
Salud de IA, uso de tokens, optimización de costos, monitoreo BYOK y limpieza segura para agentes compatibles con MCP.
SkillFM Beacon brinda a Claude Code, Cursor, Cline, Claude Desktop, VS Code Copilot y otros clientes MCP una capa práctica de operaciones de IA:
- Verifica la salud de la IA y el estado de la sesión.
- Inspecciona el uso de tokens y el gasto de LLM.
- Encuentra oportunidades de ahorro de costos en la configuración del proveedor, el uso de caché, el procesamiento por lotes y la limpieza del contexto.
- Monitorea la facturación del proveedor con claves BYOK almacenadas en una bóveda local.
- Audita el desorden que ralentiza a los agentes, como ramas de trabajo obsoletas, registros sobredimensionados y contexto inflado.
- Descubre futuras habilidades de SkillFM para contenido, redes sociales, comercio electrónico, SEO/GEO y automatización de flujos de trabajo a medida que estén disponibles.
Este repositorio es el shell de distribución pública para el listado del mercado MCP de SkillFM. El runtime local canónico es @skillfm/local.
Inicio Rápido
Usa SkillFM Beacon como servidor stdio de MCP:
npx -y @skillfm/mcp@latest
Forma explícita equivalente:
npx -y @skillfm/mcp@latest mcp
Para clientes MCP que aceptan configuración JSON:
{
"mcpServers": {
"skillfm": {
"command": "npx",
"args": ["-y", "@skillfm/mcp@latest"]
}
}
}
Ruta de Activación
El paquete MCP delega en @skillfm/local@latest, por lo que el mismo paquete puede iniciar el sidecar local y activar SkillFM en la máquina actual.
Inicia el sidecar local:
npx -y @skillfm/mcp@latest start
El sidecar se vincula solo a 127.0.0.1 y escribe su archivo de descubrimiento de servicios en:
~/.skillfm/local.json
Flujo de activación impulsado por el agente:
- Lee la URL del sidecar desde stdout o
~/.skillfm/local.json. - Llama a
POST <sidecar_url>/activate/start. - Muestra la URL de verificación devuelta y el código de dispositivo real al usuario.
- Consulta
POST <sidecar_url>/activate/pollhasta que devuelvaactivated: true. - Usa
GET <sidecar_url>/status,GET <sidecar_url>/skillso las herramientas MCP.
No inventes un código de marcador de posición. El código de dispositivo debe provenir de POST /activate/start.
Comandos Útiles
# 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
Con Qué Ayuda SkillFM
SkillFM Beacon es para usuarios que preguntan:
- "¿Cuántos tokens usé hoy?"
- "¿Por qué está subiendo mi factura de IA?"
- "¿Puedo ahorrar dinero en OpenAI, Anthropic, DeepSeek, Qwen u otros proveedores de LLM?"
- "¿Mi agente se está volviendo lento porque el contexto o el espacio de trabajo están inflados?"
- "¿Cómo conecto de forma segura una clave de proveedor sin enviarla a un panel SaaS?"
- "¿Qué habilidades puede ejecutar mi IA para contenido, comercio electrónico, redes sociales, SEO/GEO o automatización?"
Modelo de Seguridad
- Sidecar local: El sidecar de activación escucha en
127.0.0.1, no en la red pública. - Bóveda BYOK: Las claves API del proveedor se almacenan localmente mediante
@skillfm/local; los agentes no leen los valores de las claves. - Sin núcleo privado en este repositorio: Este repositorio contiene solo metadatos de distribución y un lanzador ligero. Los detalles de implementación de la plataforma no pública no están incluidos.
- Activación controlada por el usuario: La activación mediante flujo de dispositivo OAuth requiere que el usuario apruebe el código de dispositivo real en su propio navegador.
- Limpieza de solo lectura primero: Las auditorías de limpieza están diseñadas para informar sobre el desorden que ralentiza a los agentes antes de cualquier acción de limpieza dirigida por el usuario.
Consulta PRIVACY.md y SECURITY.md para conocer el límite del repositorio público.
Palabras Clave del Mercado
SkillFM Beacon está diseñado para ser descubrible para:
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.
Límite de la Superficie Pública
Este paquete público es intencionalmente pequeño. Existe para facilitar la instalación de SkillFM desde mercados MCP y directorios de agentes, manteniendo privados la seguridad central y la lógica de la plataforma.
Público:
- Metadatos del registro MCP
- Paquete lanzador npm
- Documentación de instalación
- Flujo de activación
- Modelo de seguridad
- Descripciones de herramientas orientadas al usuario
Privado:
- Implementación de plataforma no pública
- Internos de evaluación propietarios
- Prompts o configuración privados
- Datos o registros de clientes
- Credenciales de proveedores
Preparación para el Mercado
server.json.namecoincide conpackage.json.mcpName.- El paquete npm es un lanzador público ligero para
@skillfm/local. publishConfig.accessestá configurado enpublicpara la publicación npm con ámbito.- Los documentos públicos evitan afirmaciones de ingresos garantizados, ingresos pasivos y ganancias automáticas.
- El repositorio no contiene código de servicio backend, registros de clientes, claves de proveedores ni lógica de automatización no pública.
Consulta docs/MARKETPLACE-CHECKLIST.md antes de enviar a registros MCP o directorios de agentes.
Licencia
MIT