Keymaster MCP

Infraestructura de confianza para equipos humano–IA.

日本語 · Demo de cinco minutos · Guía de adopción · Filosofía · Modelo de amenazas

Keymaster permite que los agentes descubran si existen capacidades aprobadas y si sus credenciales están sanas sin devo sin devolver credenciales de produción al modelo. Su acompañero, Outcome, solo acepta resultados cuando la evidencia externa —no el propio informe del ejecutor— respalda la afirmación.

bounded permission → trusted execution → external evidence → accepted result → next permission

Exprienta la filosofía sin una credencial

cd keymaster-mcp
npm ci
npm run demo:local

El demo solo de bucle lozal usa un único valor sintético y demuestra lo siguiiente:

• secret_status devuelve available;

• get_secret no está expuesto;

• la credencial sintética nunca cruza la salida MCP visible para el rodelo;

• no se requiere ninguna cuenta de cloud, despliegue de Vault, servicio de pago ni credencial real.

El demo es una explicación ejecutable, no un proxy de producción.

Related MCP server: stillvault-mcp

Dos puntos de entrada públicos

1. Comprobar si un resulor de IA es real

Instala la habilidad pública outcome-contract de Codex:

$skill-installer install https://github.com/AInoAKARI/keymaster-mcp/tree/main/skills/outcome-contract

Úsala antes de aceptar afirmaciones como completado, enviado, pagado, entregado, tiempo ahorrado, coste reducido, riesgo eliminado o una respuesta recibida.

Llama al auditor gratuito y devuelve un veredicto, evidencia aceptada, evidencia faltante, la siguiente acción de verificación y el límite de verdad del veredicto.

Un commit, un despliegue, una publicación en el registro, un HTTP 200, una autoprueba, un autopago, una llamada interna de agente o un autoinforme del ejecutor no se considera, por sí solo, un resultado externo.

2. Consulta justa la capacidad de las credenciales sin revelarla

@akari-os/keymaster-mcp es el puente de estado de Vault no divulgativo para agentes de IA autónomos.

claude mcp add keymaster -- npx -y @akari-os/keymaster-mcp \
  --vault-url https://your-keymaster.example.com

El host del MCP suministra USER_KEYMASTER_TOKEN mediante su enlace de secreto gestionado. Los tokens sin procesar se rechazan como argumentos de línea de commandos y nunca deben pegarse en chats, prompts, entorses de shell ni ejemplos públicos.

El servidor expone:

• secret_status — comprueba una credencial aprobada sin devolver su valor;

• list_services — descubre los pares servicio/nombre de clave admitidos;

• list_secrets — lista las rutas aprobadas solo como metadatos;

• healthcheck — valida creencias en el origen y devuelve solo estados;

• rotate_secret — devuelve una guía segura de rotación sin aceptar un valor de sustitución.

El modelo de confianza

Cabledad without custodia de credenciales

El modelo puede saber qué cápacita existe y que funciona. Una carga de trabajo confiable consume la credencial detrás del límite; el modelo nunca ve el secret.

Confianza com evidencia

Al agente se le permite actuar, pero su propio mensaje de finalización no se acepta como prueba de valor exitoso.

Filosofía como protocolo

Los valores se implementan en el comportamiento del sistema: salida MCP no reveladora, acceso de lectura con ámbito, rutas de escritura separadas, una única fuente de verdad, llamadas de red limitadas, límites de evidencia y nuevas acciones de verificación explícitas.

De la demo a la adopción real

1. Ejecuta la demo de cero secretos;

2. Registra un secreto de bajo riesgo en Vault;

3. Conecta Keymaster con un binding de secret gué de host de solo lectura;

4. Deja que el agente verifique la disponibilidad mediante secret_status;

5. Ejecuta la acción autenticada dentro de la frontera de la carga de trabajo confiable;

6. Aplica la Outcome Contract en el límite de aceptación;

7. Conserva el paquete de evidencia y el recibo de resultado.

Consulta la guía de adopción para conocer los límites exactos.

El éxito no es la instalación. El éxito es un paso humano eliminado, una ruta de fuga cerrada, una obligación completada, tiempo recuperado, un coste evitado, un riesgo eliminado o un valor reconocido de forma independiente.

¿Lo has usado en flujo real? Envía una reporte de adopción real con marcadores de evidencia redactados y un límite de verdad explícito. Nunca incluyas credenciales, tokens de portador, URLs privadas, datos personales ni evidencia confidencial.

Controles actuales de interoperabilidad y cadena de suministro

• Compatibilidad con MCP TypeScript SDK v1 estable;

• metadatos oficiales de registro server.json;

• smoke test oficial de MCP Inspector;

• puertas de compatibilidad Node 18, 20, 22 y 24;

• pasarela de compatibilidad de la última versión estable del MCP SDK v1;

• publicación confiable de npm y provenance;

• CycloneDX SBOM y attestaciones de artefactos de GitHub;

• análisis CodeQL v4 security-extended;

• publicación de OpenSSF Scorecard mediante OIDC;

• actualizaciones Dependabot semanales para npm y GitHub Actions.

Estos controles solo cuentan como operativos después de que los workflows se ejecuten y la evidencia sea observable.

Las vistas previas y las extensiones experimentales no se añaden para experimentos. Entran solo si se mantienen el secreto, el mínimo privilegio y la evidencia observable.

Participación en el proyecto

• Contribuciones

• Governance

• Política de seguridad

• Changelog

AIﾉアカリ☆

AIﾉアカリ☆ es co-creación humano-IA de Japón.

Humans aportan presencia, cuidado, ética, transparencia y contexto vivido. AI aporta computación, memoria, búsqueda, síntesis y continuidad. Keymaster intenta evitar que los humanos tengan que copiar secretos repetidamente sin convertir a la IA en un demonio en un custodian ilimitado.

Descubrimiento de agentes de IA

• Entrada de IA: https://ai-akari.ai/agents

• RSS: https://ai-akari.ai/feed.xml

• llms.txt: https://ai-akari.ai/llms.txt

• agents.json: https://ai-akari.ai/agents.json

MIT License