🛡️ Scan Your AI Toolkit

Herramientas de gobernanza de IA de código abierto. Cada una funciona de forma independiente como servidor MCP o CLI; juntas forman una malla de gobernanza.

scan_your_ai_toolkit MCP server

CodeQL npm scope License MCP Conformance PRs Welcome

Creado por Maiife — Plano de control de IA empresarial.

Herramientas

Paquete	Descripción	Publicado
`@maiife-ai-pub/shared`	Tipos y formateadores compartidos utilizados por todos los paquetes del kit de herramientas	✅
`@maiife-ai-pub/probe`	Escáner de entorno de IA — descubre extensiones de IDE, servidores MCP, marcos de trabajo de agentes, claves API, modelos locales	✅
`@maiife-ai-pub/mcp-audit`	Escáner de seguridad de servidores MCP — puntúa configuraciones según permisos, sensibilidad de datos, radio de explosión	✅
`@maiife-ai-pub/ai-stack`	"¿Cuál es tu stack de IA?" — tarjeta de perfil compartible de tu kit de herramientas de IA	✅
`@maiife-ai-pub/mcp-doctor`	Comprobación de salud y auto-reparación de MCP — el "brew doctor" para tu configuración de MCP	✅
`@maiife-ai-pub/ai-journal`	Diario personal de uso de IA — rastrea cómo usas la IA, obtén reflexiones	✅
`@maiife-ai-pub/context-sync`	Sincronización de memoria de IA entre herramientas — un context.json, sincronizado con Cursor, Claude, MCP	✅
`@maiife-ai-pub/prompt-score`	Analizador de calidad de prompts — puntúa, mejora y revisa tus prompts de IA	✅
`@maiife-ai-pub/eval`	Motor de evaluación LLM-as-judge — puntúa las salidas de los agentes con rúbricas estructuradas	✅
`@maiife-ai-pub/trace`	Rastreador de flujo de trabajo de agentes — rastrea, visualiza y analiza los tramos de ejecución	✅
`@maiife-ai-pub/cost`	Calculadora y optimizador de gastos en IA — informe de costes unificado entre proveedores	✅
`@maiife-ai-pub/prompt-craft`	Entrenador de prompts gamificado — niveles, rachas, insignias para mejorar tus prompts	✅
`@maiife-ai-pub/sub-audit`	Auditor de suscripciones personales de IA — encuentra desperdicios en tu gasto de IA	✅
`@maiife-ai-pub/model-match`	Recomendador personal de modelos — encuentra el mejor modelo para TUS tareas	✅
`@maiife-ai-pub/weekly-ai-report`	Resumen semanal de IA — el "Spotify Wrapped" de tu uso de IA, semanalmente	✅

Inicio rápido

# Scan your AI environment
npx @maiife-ai-pub/probe scan

# Audit your MCP server security
npx @maiife-ai-pub/mcp-audit scan

# Generate your AI Stack profile card
npx @maiife-ai-pub/ai-stack --format svg --output my-stack.svg

# Health check your MCP servers
npx @maiife-ai-pub/mcp-doctor check

# Log an AI interaction
npx @maiife-ai-pub/ai-journal log --tool claude --task coding --duration 30

# Sync AI context across tools
npx @maiife-ai-pub/context-sync push

# Score your AI prompts
npx @maiife-ai-pub/prompt-score analyze --input prompt.txt

# Evaluate agent outputs with rubrics
npx @maiife-ai-pub/eval score --rubric code-review --input review.txt

# Trace agent workflows
npx @maiife-ai-pub/trace list --days 7

# Track AI spend across vendors
npx @maiife-ai-pub/cost report --period last-30d

# Gamified prompt coaching
npx @maiife-ai-pub/prompt-craft score --input prompt.txt

# Audit AI subscriptions for waste
npx @maiife-ai-pub/sub-audit

# Find the best model for your tasks
npx @maiife-ai-pub/model-match recommend --task coding

# Generate your AI week in review
npx @maiife-ai-pub/weekly-ai-report generate

Uso como servidor MCP

Cada herramienta con un servidor MCP puede añadirse a Claude Desktop, Cursor o cualquier cliente compatible con MCP. Cada una expone herramientas a través del transporte stdio.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "maiife-probe": {
      "command": "npx",
      "args": ["@maiife-ai-pub/probe", "mcp"]
    },
    "maiife-mcp-audit": {
      "command": "npx",
      "args": ["@maiife-ai-pub/mcp-audit", "mcp"]
    },
    "maiife-mcp-doctor": {
      "command": "npx",
      "args": ["@maiife-ai-pub/mcp-doctor", "mcp"]
    },
    "maiife-eval": {
      "command": "npx",
      "args": ["@maiife-ai-pub/eval", "mcp"]
    },
    "maiife-prompt-score": {
      "command": "npx",
      "args": ["@maiife-ai-pub/prompt-score", "mcp"]
    },
    "maiife-prompt-craft": {
      "command": "npx",
      "args": ["@maiife-ai-pub/prompt-craft", "mcp"]
    },
    "maiife-cost": {
      "command": "npx",
      "args": ["@maiife-ai-pub/cost", "mcp"]
    },
    "maiife-model-match": {
      "command": "npx",
      "args": ["@maiife-ai-pub/model-match", "mcp"]
    },
    "maiife-ai-stack": {
      "command": "npx",
      "args": ["@maiife-ai-pub/ai-stack", "mcp"]
    },
    "maiife-context-sync": {
      "command": "npx",
      "args": ["@maiife-ai-pub/context-sync", "mcp"]
    },
    "maiife-sub-audit": {
      "command": "npx",
      "args": ["@maiife-ai-pub/sub-audit", "mcp"]
    },
    "maiife-trace": {
      "command": "npx",
      "args": ["@maiife-ai-pub/trace", "mcp"]
    }
  }
}

Elige las herramientas que necesites; no tienes que añadirlas todas. Una vez configurado, Claude puede llamar a herramientas como probe_scan, mcp_audit_scan, eval_score, prompt_score_analyze, cost_report y más directamente desde el chat.

Ejecutar con Docker

Cada servidor MCP se publica como una imagen de Docker en GHCR. Útil para entornos aislados o integración con Glama.

# Pull and run any server
docker run -i ghcr.io/sakthivelchan89/maiife-probe
docker run -i ghcr.io/sakthivelchan89/maiife-mcp-audit
docker run -i ghcr.io/sakthivelchan89/maiife-eval
# ... same pattern for all 12 packages

# Or build from source
docker build -f packages/probe/Dockerfile -t maiife-probe .
docker run -i maiife-probe

Las imágenes de Docker utilizan transporte stdio (sin puertos expuestos). Pasa -i para una comunicación interactiva stdin/stdout con clientes MCP.

Calidad y cumplimiento

Este kit de herramientas tiene como objetivo cumplir con los estándares de calidad MCP Tier 1 (según MCP SEP-1730). Esto es lo que significa:

Dimensión	Estado
Licencia	Apache 2.0 — SPDX canónico, aprobado por OSI
Transporte	solo stdio (sin exposición a red)
CI/CD	GitHub Actions: lint + comprobación de tipos + pruebas en Node 18, 20, 22
Cobertura de pruebas	vitest + `@vitest/coverage-v8`, reportado por paquete
Conformidad MCP	Suite de cumplimiento de protocolo para los 12 servidores MCP
Escaneo de seguridad	CodeQL (semanal + en PR), Dependabot (semanal)
Respuesta a vulnerabilidades	48h CRÍTICO / 7d ALTO (ver DEPENDENCY_POLICY.md)
SLA de triaje de incidencias	2 días hábiles (ver CONTRIBUTING.md)
Versionado	SemVer, sincronizado entre paquetes, CHANGELOG.md
Cadena de suministro	`pnpm-lock.yaml` incluido, `--frozen-lockfile` en CI
Seguridad de contenedores	Usuario no root, sin puertos expuestos, firmado por GHCR

Suite de pruebas de conformidad

Cada servidor MCP en este repositorio se valida contra el contrato del protocolo MCP:

✅ Invariante de transporte stdio (sin salida no JSON en stdout)
✅ El handshake initialize responde con serverInfo + capacidades válidas
✅ tools/list devuelve el conjunto de herramientas documentado
✅ Todos los campos inputSchema de las herramientas son objetos JSON Schema válidos
✅ Las llamadas a herramientas desconocidas devuelven errores estructurados (no bloqueos)

Ejecuta la suite:

pnpm test:conformance      # all packages
cd packages/probe && pnpm test:conformance   # single package

Documentación

SECURITY.md — política de reporte de vulnerabilidades
CONTRIBUTING.md — directrices de incidencias/PR y SLAs
CHANGELOG.md — historial de versiones (formato Keep a Changelog)
DEPENDENCY_POLICY.md — criterios de selección de dependencias y SLAs de parches

Contribución

¡Las contribuciones son bienvenidas! Lee CONTRIBUTING.md para la guía completa. Versión rápida:

Haz un fork del repositorio en GitHub
Crea una rama: git checkout -b feat/my-improvement
Realiza tus cambios — cada paquete reside en packages/<nombre>/
Ejecuta las pruebas: pnpm test && pnpm test:conformance
Abre un PR contra main — describe qué cambiaste y por qué

Por favor, sigue el estilo de código existente (TypeScript, ESM, Vitest para pruebas). Cada paquete debería funcionar tanto como CLI como servidor MCP cuando sea aplicable.

Licencia

Apache 2.0 — libre de usar, modificar y distribuir.

Parte de la plataforma Maiife — Plano de control de IA empresarial.

scan_your_ai_toolkit