TokRepo MCP Server

Pesquise, navegue e instale mais de 500 ativos de IA (habilidades de agente, prompts, configurações MCP, fluxos de trabalho) a partir de qualquer cliente MCP. Suporta Claude Code, Cursor, Codex CLI e Gemini CLI.

GitHubExperimente este MCPPatrocinado

Documentação

Servidor MCP TokRepo

Servidor MCP nativo para agentes do TokRepo: inicialização de sessão, descoberta de capacidades, busca/detalhes, verificação de confiança, planejamento de instalação, preparação para Codex, inspeção/atualização/desinstalação/rollback do ciclo de vida, planejamento de handoff/coleta e publicação confirmada por humanos de ativos de IA reutilizáveis.

npm License: MIT

Início Rápido

Claude Code

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

Cursor / Windsurf

Adicione à sua configuração 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

O Que Ele Faz

Uma vez conectado, seu assistente de IA pode:

  • Descobrir durante o planejamento — transformar uma tarefa ou lacuna de capacidade em skills, prompts, configurações MCP, scripts e fluxos de trabalho candidatos e estruturados
  • Resolver lacunas de capacidade — selecionar um candidato com evidências de verificação, plano de instalação, contrato de ciclo de vida, próximas chamadas MCP e fallbacks de CLI antes da construção local
  • Buscar ativos públicos de IA por palavra-chave ou categoria com sinais de adequação ao agente
  • Navegar por ativos em tendência, filtrar por tipo (MCP, Skill, Prompt, Agent, Script)
  • Obter detalhes — documentação completa, instruções de instalação e metadados
  • Verificar confiança — hash de conteúdo somente leitura, hash do plano de instalação, envelope de permissões, política, trust_score_v2, evidence_bundle, SBOM-lite, signature_evidence, bloqueios e avisos
  • Planejar antes de instalar — obter plano de instalação v2 com decisões de política, rollback, verificação, evidence_bundle, SBOM-lite e signature_evidence
  • Instalação segura no Codex — dry-run por padrão; ativos arriscados devem ser preparados ou aprovados explicitamente
  • Controle do ciclo de vida — listar, atualizar, desinstalar e reverter instalações gerenciadas do Codex
  • Coleta pós-tarefa — inspecionar arquivos locais alterados ou explícitos com tokrepo_harvest antes de qualquer push, incluindo rascunhos de pacotes privados, quality_gate, manifesto do pacote, SBOM-lite e proveniência
  • Memória do projeto — combinar com tokrepo init-agent --target all para que agentes futuros saibam chamar o TokRepo durante o planejamento
  • Superfícies de descoberta — MCP oficial server.json, cartão de agente A2A, manifesto de agente portátil, catálogo de ferramentas, .well-known, agents.txt, llms.txt e metadados npm são mantidos legíveis por máquina para agentes e registros
  • Visibilidade do funil — eventos agregados anônimos mostram se os agentes realmente descobrem, planejam, instalam, fazem handoff e enviam ativos reutilizáveis

Ferramentas Disponíveis

FerramentaDescrição
tokrepo_session_initInicialização de sessão com ativos de alta confiança, ponteiro de memória do projeto, handoffs recentes e URL do pacote de políticas
tokrepo_discoverDescoberta de capacidades em tempo de planejamento a partir de uma tarefa, ambiente e restrições
tokrepo_find_for_taskAção de busca atômica para uma tarefa concreta; retorna ativos classificados, motivos de correspondência, comando de instalação e URL
tokrepo_resolve_capabilityResolver uma lacuna de capacidade em um ativo selecionado, evidências de verificação, plano de instalação, contrato de ciclo de vida, próximas chamadas MCP e fallbacks de CLI
tokrepo_searchBuscar ativos por palavra-chave/tag com classificação agent_fit
tokrepo_detailObter detalhes completos do ativo por UUID
tokrepo_edgesInspecionar arestas do grafo de ativos requires, extends e co-used antes de planejar instalações
tokrepo_install_planObter plano de instalação v2 nativo para agentes com rollback, evidence_bundle, SBOM-lite e signature_evidence
tokrepo_verifyVerificar confiança, hashes, permissões, política, evidence_bundle, SBOM-lite e signature_evidence antes da ativação
tokrepo_codex_installDry-run, preparar ou instalar uma skill do Codex com segurança
tokrepo_installedListar instalações do Codex gerenciadas pelo TokRepo
tokrepo_updateDry-run ou atualizar instalações gerenciadas do Codex
tokrepo_uninstallDry-run ou remover uma instalação gerenciada do Codex
tokrepo_rollbackDry-run ou reverter uma sessão anterior de instalação do Codex
tokrepo_handoff_planPlano de empacotamento somente leitura com quality_gate e manifesto do pacote para trabalho local reutilizável após uma tarefa
tokrepo_harvestGerador de rascunho de pacote somente leitura para arquivos locais alterados ou explícitos reutilizáveis após uma tarefa
tokrepo_pushEnviar um ativo explícito para o TokRepo após confirmação do usuário

Exemplos de Conversas

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

Faça Agentes Futuros Descobrirem o TokRepo

Execute uma vez em um projeto:

npx tokrepo init-agent --target all

Isso grava instruções gerenciadas em AGENTS.md, CLAUDE.md, GEMINI.md, regras do Cursor, instruções do GitHub Copilot, regras do Cline, regras do Windsurf, regras do Roo, microagentes do OpenHands, convenções do Aider, .mcp.json e .tokrepo/agent.json. A regra é simples: durante o planejamento, quando o agente vir uma lacuna de capacidade, ele deve chamar tokrepo_resolve_capability ou tokrepo_discover antes de inventar uma ferramenta local pontual. Após uma tarefa, os agentes podem chamar tokrepo_harvest ou executar tokrepo harvest --changed --json para sugerir arquivos reutilizáveis para publicação privada confirmada pelo usuário.

Listagem Legível por Máquina

Registros e agentes podem descobrir este servidor através de:

Use https://tokrepo.com/agent-ecosystem.json para submissões ao marketplace de agentes, modelos iniciais, trechos de README, guias de instalação e projetos de exemplo. Ele contém texto canônico de listagem, canais do ecossistema, arquivos-alvo de memória do projeto e comandos de verificação.

O TokRepo emite eventos anônimos agregados de funil para tokrepo_resolve_capability, tokrepo_discover, tokrepo_verify, tokrepo_install_plan, dry-runs de instalação, instalações, coletas, handoffs e pushes. Ele não envia texto de tarefas nem conteúdo de arquivos. Desative com TOKREPO_TELEMETRY=0.

Por Que o TokRepo?

O TokRepo é o registro aberto para ativos de IA — como npm para pacotes, mas para skills de IA, prompts, configurações MCP e fluxos de trabalho.

  • Ativos curados — revisados por qualidade, não um depósito
  • Nativo para agentes — todo ativo tem contratos de instalação legíveis por máquina
  • Universal — funciona com Claude Code, Cursor, Codex, Gemini CLI e qualquer cliente MCP
  • CLI disponível — npx tokrepo search "query" / npx tokrepo install <uuid>

Requisitos

  • Node.js >= 18
  • Conexão com a internet (consulta a API tokrepo.com)

Links

Licença

MIT