TokRepo MCP Server

Busca, explora e instala más de 500 activos de IA (habilidades de agente, prompts, configuraciones MCP, flujos de trabajo) desde cualquier cliente MCP. Compatible con Claude Code, Cursor, Codex CLI y Gemini CLI.

Documentación

Servidor MCP de TokRepo

Servidor MCP nativo para agentes de TokRepo: arranque de sesión, descubrimiento de capacidades, búsqueda/detalle, verificación de confianza, planificación de instalación, preparación de Codex, inspección/ciclo de vida/actualización/desinstalación/rollback, planificación de traspaso/recolección y publicación confirmada por humanos de activos de IA reutilizables.

npm License: MIT

Inicio rápido

Claude Code

claude mcp add tokrepo -- npx -y tokrepo-mcp-server

Cursor / Windsurf

Añade a tu configuración de MCP (~/.cursor/mcp.json):

{
  "mcpServers": {
    "tokrepo": {
      "command": "npx",
      "args": ["-y", "tokrepo-mcp-server"]
    }
  }
}

OpenAI Codex / Gemini CLI

codex mcp add tokrepo -- npx -y tokrepo-mcp-server
gemini settings mcp add tokrepo -- npx -y tokrepo-mcp-server

Qué hace

Una vez conectado, tu asistente de IA puede:

  • Descubrir durante la planificación — convertir una tarea o brecha de capacidad en habilidades, prompts, configuraciones de MCP, scripts y flujos de trabajo candidatos estructurados
  • Resolver brechas de capacidad — seleccionar un candidato con evidencia de verificación, plan de instalación, contrato de ciclo de vida, próximas llamadas MCP y alternativas de CLI antes de la compilación local
  • Buscar activos públicos de IA por palabra clave o categoría con señales de ajuste para agentes
  • Explorar activos en tendencia, filtrar por tipo (MCP, Skill, Prompt, Agent, Script)
  • Obtener detalles — documentación completa, instrucciones de instalación y metadatos
  • Verificar confianza — hash de contenido de solo lectura, hash del plan de instalación, envoltorio de permisos, política, trust_score_v2, evidence_bundle, SBOM-lite, signature_evidence, bloqueadores y advertencias
  • Planificar antes de instalar — obtener plan de instalación v2 con decisiones de política, rollback, verificación, evidence_bundle, SBOM-lite y signature_evidence
  • Instalación segura de Codex — prueba en seco por defecto; los activos riesgosos deben prepararse o aprobarse explícitamente
  • Control del ciclo de vida — listar, actualizar, desinstalar y revertir instalaciones gestionadas de Codex
  • Recolección posterior a la tarea — inspeccionar archivos locales modificados o explícitos con tokrepo_harvest antes de cualquier push, incluidos borradores de paquetes privados, quality_gate, manifiesto de paquete, SBOM-lite y procedencia
  • Memoria del proyecto — combinar con tokrepo init-agent --target all para que los futuros agentes sepan llamar a TokRepo durante la planificación
  • Superficies de descubrimiento — MCP oficial server.json, tarjeta de agente A2A, manifiesto de agente portátil, catálogo de herramientas, .well-known, agents.txt, llms.txt y metadatos de npm se mantienen legibles por máquina para agentes y registros
  • Visibilidad del embudo — eventos agregados anónimos muestran si los agentes realmente descubren, planifican, instalan, traspasan y publican activos reutilizables

Herramientas disponibles

HerramientaDescripción
tokrepo_session_initArranque de sesión con activos de alta confianza, puntero de memoria del proyecto, traspasos recientes y URL del paquete de políticas
tokrepo_discoverDescubrimiento de capacidades en tiempo de planificación a partir de una tarea, entorno y restricciones
tokrepo_find_for_taskAcción de búsqueda atómica para una tarea concreta; devuelve activos clasificados, razones de coincidencia, comando de instalación y URL
tokrepo_resolve_capabilityResolver una brecha de capacidad en un activo seleccionado, evidencia de verificación, plan de instalación, contrato de ciclo de vida, próximas llamadas MCP y alternativas de CLI
tokrepo_searchBuscar activos por palabra clave/etiqueta con clasificación agent_fit
tokrepo_detailObtener detalles completos del activo por UUID
tokrepo_edgesInspeccionar bordes del grafo de activos requires, extends y co-used antes de planificar instalaciones
tokrepo_install_planObtener plan de instalación v2 nativo para agentes con rollback, evidence_bundle, SBOM-lite y signature_evidence
tokrepo_verifyVerificar confianza, hashes, permisos, política, evidence_bundle, SBOM-lite y signature_evidence antes de la activación
tokrepo_codex_installPrueba en seco, preparación o instalación segura de una skill de Codex
tokrepo_installedListar instalaciones de Codex gestionadas por TokRepo
tokrepo_updatePrueba en seco o actualización de instalaciones gestionadas de Codex
tokrepo_uninstallPrueba en seco o eliminación de una instalación gestionada de Codex
tokrepo_rollbackPrueba en seco o rollback de una sesión de instalación previa de Codex
tokrepo_handoff_planPlan de empaquetado de solo lectura con quality_gate y manifiesto de paquete para trabajo local reutilizable después de una tarea
tokrepo_harvestGenerador de borrador de paquete de solo lectura para archivos locales modificados o explícitos reutilizables después de una tarea
tokrepo_pushPublicar un activo explícito en TokRepo después de la confirmación del usuario

Conversaciones de ejemplo

You: "Find me a good MCP server for databases"
AI: [calls tokrepo_resolve_capability] → Ranks DBHub, Supabase MCP, PostgreSQL MCP and returns verification/install-plan evidence for the selected candidate

You: "What video assets should I install?"
AI: [calls tokrepo_resolve_capability] → Finds relevant skills, checks fit, trust, and policy, then asks before installing

You: "Install that cursor rules asset"
AI: [calls tokrepo_verify] → Checks trust_score_v2, permissions, blockers, and warnings
AI: [calls tokrepo_install_plan] → Reviews policy and actions
AI: [calls tokrepo_codex_install with dry_run=false, confirm=true] → Writes only after explicit confirmation
AI: [calls tokrepo_rollback with dry_run=true] → Shows exactly what would be removed before rollback

You: "We created a reusable project rule; save it for future agents"
AI: [calls tokrepo_harvest] → Returns explicit files, hashes, quality_gate, package drafts, SBOM-lite, provenance, metadata defaults, and private-by-default push guidance
AI: [asks for confirmation before tokrepo_push] → Uploads only reviewed files

Haz que los futuros agentes descubran TokRepo

Ejecuta esto una vez en un proyecto:

npx tokrepo init-agent --target all

Escribe instrucciones gestionadas en AGENTS.md, CLAUDE.md, GEMINI.md, reglas de Cursor, instrucciones de GitHub Copilot, reglas de Cline, reglas de Windsurf, reglas de Roo, microagentes de OpenHands, convenciones de Aider, .mcp.json y .tokrepo/agent.json. La regla es simple: durante la planificación, cuando el agente vea una brecha de capacidad, debe llamar a tokrepo_resolve_capability o tokrepo_discover antes de inventar una herramienta local de un solo uso. Después de una tarea, los agentes pueden llamar a tokrepo_harvest o ejecutar tokrepo harvest --changed --json para sugerir archivos reutilizables para publicación privada confirmada por el usuario.

Listado legible por máquina

Los registros y agentes pueden descubrir este servidor a través de:

Usa https://tokrepo.com/agent-ecosystem.json para envíos al marketplace de agentes, plantillas de inicio, fragmentos de README, guías de instalación y proyectos de ejemplo. Contiene texto de listado canónico, canales del ecosistema, archivos de memoria de proyecto objetivo y comandos de verificación.

TokRepo emite eventos de embudo agregados anónimos para tokrepo_resolve_capability, tokrepo_discover, tokrepo_verify, tokrepo_install_plan, pruebas en seco de instalación, instalaciones, recolecciones, traspasos y publicaciones. No envía texto de tareas ni contenido de archivos. Desactívelo con TOKREPO_TELEMETRY=0.

¿Por qué TokRepo?

TokRepo es el registro abierto para activos de IA — como npm para paquetes, pero para skills de IA, prompts, configuraciones de MCP y flujos de trabajo.

  • Activos curados — revisados por calidad, no un vertedero
  • Nativo para agentes — cada activo tiene contratos de instalación legibles por máquina
  • Universal — funciona con Claude Code, Cursor, Codex, Gemini CLI y cualquier cliente MCP
  • CLI disponible — npx tokrepo search "query" / npx tokrepo install <uuid>

Requisitos

  • Node.js >= 18
  • Conexión a Internet (consulta la API de tokrepo.com)

Enlaces

Licencia

MIT