@edilsonfjdev/claude-agents-core

MCP Server para o core protegido do ecossistema Claude Agents v1.4.1. Serve o conteudo dos 54 agentes (10 orquestradores + 44 experts), knowledge base, templates e instrucoes a partir de um bundle encriptado com AES-256-GCM.

v1.4.1 (2026-04-28): bundle agora embute manifest.json (sha256 por arquivo, ADR-008) para validacao pos-decrypt e suporte a update cirurgico do CLI. Sem mudancas de API publica do MCP (compativel com clientes v1.4.0).

Como Funciona

O conteudo do ecossistema (agentes, knowledge, templates, instrucoes) e empacotado em um unico arquivo encriptado (core.enc). Este MCP Server descriptografa o bundle usando a chave de licenca do usuario e expoe o conteudo atraves de 6 ferramentas MCP.

                     Claude Code
                         |
                    MCP Protocol (stdio)
                         |
              claude-agents-core (MCP Server)
              ┌──────────────────────────┐
              │  License Validation      │
              │  AES-256-GCM Decryption  │
              │  6 Tools (agents, kb...) │
              └──────────────────────────┘
                         |
                    data/core.enc
              (bundle encriptado)

Instalacao

Via npx (Recomendado)

claude mcp add claude-agents-core -e CLAUDE_AGENTS_LICENSE=EDJR-xxxx-xxxx-xxxx -- npx -y @edilsonfjdev/claude-agents-core

Via npm global

npm install -g @edilsonfjdev/claude-agents-core

claude mcp add claude-agents-core -e CLAUDE_AGENTS_LICENSE=EDJR-xxxx-xxxx-xxxx -- claude-agents-core

Via settings.local.json

{
  "mcpServers": {
    "claude-agents-core": {
      "command": "npx",
      "args": ["-y", "@edilsonfjdev/claude-agents-core"],
      "env": {
        "CLAUDE_AGENTS_LICENSE": "EDJR-xxxx-xxxx-xxxx"
      }
    }
  }
}

Configuracao

Variavel de Ambiente

| Variavel | Descricao | Obrigatoria | |----------|-----------|-------------| | CLAUDE_AGENTS_LICENSE | Chave de licenca do ecossistema | Sim |

A chave pode ser configurada de 3 formas:

1. Variavel de ambiente (prioridade mais alta):

   export CLAUDE_AGENTS_LICENSE="EDJR-xxxx-xxxx-xxxx"

2. Arquivo de configuracao (cache local):

   // ~/.claude-agents/license.json
   {
     "key": "EDJR-xxxx-xxxx-xxxx",
     "tier": "standard",
     "company": "Minha Empresa"
   }

3. Flag de ambiente no MCP (via Claude Code):

   claude mcp add claude-agents-core -e CLAUDE_AGENTS_LICENSE=EDJR-xxxx-xxxx-xxxx -- npx -y @edilsonfjdev/claude-agents-core

Ferramentas Disponiveis

get_agent

Retorna o conteudo completo de um agente especifico.

Input: { name: "lucas" }
Output: Markdown completo do agente Lucas (Backend Expert)

get_knowledge

Busca conteudo na knowledge base por stack e topico.

Input: { stack: "nestjs", topic: "api" }
Output: Conteudo sobre API em NestJS

get_template

Retorna um template de documento.

Input: { type: "ir" }
Output: Template do Implementation Report

get_instructions

Retorna o CLAUDE.md completo ou uma secao especifica.

Input: { section: "principles" }
Output: Secao de principios do CLAUDE.md

Input: {} (sem parametros)
Output: CLAUDE.md completo

list_agents

Lista agentes disponiveis com metadados.

Input: { type: "orchestrator" }
Output: Tabela com os 10 orquestradores

Input: { type: "all" }
Output: Tabela com todos os 54 agentes

validate_license

Verifica o status atual da licenca.

Input: {} (sem parametros)
Output: Status, tier, empresa, expiracao

Seguranca

• O bundle e encriptado com AES-256-GCM (autenticado)
• A chave e derivada via PBKDF2 (100.000 iteracoes, SHA-256)
• A chave de licenca nunca e enviada para o Claude Code
• O bundle e descriptografado em memoria (nao escrito em disco)
• Validacao de licenca com grace period de 30 dias para uso offline

Geracao do Bundle

O bundle core.enc e gerado pelo script scripts/encrypt-core.js na raiz do repositorio:

node scripts/encrypt-core.js --key "EDJR-xxxx-xxxx-xxxx"

Este script:

1. Le todos os arquivos de .claude-standard/
2. Empacota em um JSON estruturado
3. Encripta com AES-256-GCM usando a chave fornecida
4. Salva em tools/claude-agents-core-mcp/data/core.enc

Dependencias

| Pacote | Versao | Funcao | |--------|--------|--------| | @modelcontextprotocol/sdk | ^1.0.0 | Protocolo MCP (stdio) | | crypto (built-in) | - | AES-256-GCM, PBKDF2 | | fs, path, os (built-in) | - | I/O de arquivos | | https (built-in) | - | Validacao online de licenca |

Desenvolvimento

# Clone o repositorio
git clone https://github.com/edilsonfj/claude-agents.git
cd claude-agents/tools/claude-agents-core-mcp

# Instale dependencias
npm install

# Execute localmente
CLAUDE_AGENTS_LICENSE="EDJR-dev-test-key" npm start

Licenca

MIT

Autor

Edilson de Freitas Junior [email protected]

Parte do Ecossistema Claude Agents v1.2.9