shipcheck-mcp

Descubre qué filtra tu app creada con IA — antes de que la publiques.

Funciona con Claude Code, OpenCode, Cursor o cualquier agente compatible con MCP: es un servidor estándar de Model Context Protocol, no una herramienta exclusiva de Claude.

Los agentes de codificación con IA publican alegremente apps que filtran claves de API, incorporan paquetes con licencia GPL, dejan rutas de administración abiertas a internet, recopilan correos electrónicos sin política de privacidad o tocan números de tarjeta en bruto, porque «¿funciona?» y «¿es seguro publicar esto?» son preguntas distintas, y tu agente solo responde a la primera.

ShipCheck responde a la segunda. Ejecuta cinco comprobaciones rápidas y deterministas sobre tu proyecto y explica cada hallazgo en palabras sencillas: qué está mal, por qué es importante para ti y exactamente cómo solucionarlo. No se necesitan conocimientos de seguridad.

Honesto por diseño: ShipCheck señala patrones de riesgo. No es una revisión legal ni una garantía. Un escaneo limpio significa que nada coincidió con estas comprobaciones específicas — nada más. Consulta PRD.md §2 para los no-objetivos completos.

Dos herramientas, dos momentos

La skill incluida enseña a tu agente el hábito: scan_diff antes de los commits, scan_repo antes del lanzamiento.

Related MCP server: agentguard

Funciona con tu stack

Cada resumen te indica qué stacks detectó (project_types) y te advierte honestamente cuando un stack detectado no está completamente cubierto (coverage_caveat) en lugar de dar a entender que todo está bien.

Aspecto de un hallazgo

[crítico] lib/firebase_options.dart — Posible clave de API de Google encontrada en código que se ejecuta en los dispositivos de los usuarios.

Por qué es importante: Esta clave viaja dentro de tu app hasta el teléfono o navegador de cada usuario. Cualquiera puede copiarla y usarla como si fuera tú: gastando tu dinero o leyendo tus datos.

La solución: Mueve la clave a un archivo de secretos separado que nunca forme parte del proyecto, cárgalo al iniciar y luego obtén una clave nueva desde el panel del proveedor: trata esta como robada.

Inicio en 30 segundos

# In Claude Code:
/plugin marketplace add noureldeensalama/shipcheck
/plugin install shipcheck

# Then just talk to your agent:

«ejecuta shipcheck antes de que haga commit» · «¿está esto listo para lanzarse?» · «escanea este repositorio»

Headless / CI:

claude --plugin-dir /path/to/shipcheck -p "Run shipcheck scan_repo on . and summarize findings"

Servidor MCP independiente (Cursor, OpenCode, cualquier otra cosa)

git clone https://github.com/noureldeensalama/shipcheck.git
cd shipcheck && npm install && npm run build

{
  "mcpServers": {
    "shipcheck": { "command": "node", "args": ["/absolute/path/to/shipcheck/dist/index.js"] }
  }
}

O una vez publicado: npx shipcheck-mcp

Diseñado para ser confiable

• Determinista: solo regex + metadatos de dependencias. Un LLM explica los hallazgos posteriormente; nunca decide si un hallazgo existe (PRD.md §4).

• Discreto por diseño: las claves idénticas se deduplican en un solo hallazgo con todas las ubicaciones; la salida está ordenada por severidad, es compacta (~1k tokens en un repositorio de 100k LOC), limitada a 100 hallazgos con una marca de truncamiento explícita; los árboles de dependencias (node_modules, .venv, build…) nunca se escanean; los valores de marcador de posición (mock…, dummies de CI) y las configuraciones públicas por diseño (google-services.json, firebase_options.dart) no dan falsas alarmas.

• Probado en código real: usado internamente en cinco repositorios de producción: detectó una clave Supabase service-role activa en 13 archivos y tres endpoints de depuración sin autenticación, luego verificó que las correcciones se aplicaron y señaló una segunda clave que solo sobrevivió en el historial de git. Registro completo de verdaderos/falsos positivos: DOGFOOD_RESULTS.md.

Compatibilidad

Pruébalo tú mismo

npm test             # 53 unit tests
npm run e2e          # 21 real-MCP-protocol checks
npm run verify-fixture   # acceptance gate over deliberately-vulnerable fixtures
npm run dogfood -- /path/to/any/repo   # scan any repo from the CLI

Contribuciones

Las issues y los PRs son bienvenidos: consulta CONTRIBUTING.md. Las nuevas categorías de detectores necesitan tanto un fixture que se active ante el riesgo como una prueba de regresión que no se dispare en exceso; los informes de falsos positivos con muestras de código real son especialmente valiosos. Los resultados de repositorios reales están en DOGFOOD_RESULTS.md.

Licencia

MIT — consulta LICENSE.