@neuranix/mcp-server

Plug-in MCP de memória persistente autônoma para agentes de IA em qualquer IDE compatível com MCP.

Produção: https://neuranix.com.br/api/neuranix · Versão: 1.3.6

O que já vem incluído (sem configurar regras manualmente)

Ao importar o MCP, o agente recebe automaticamente:

• Instruções do servidor (instructions) — protocolo: context no início, recall antes de tarefas, store/checkpoint no fim
• Tools com alwaysLoad: true — neuranix_context, neuranix_recall, neuranix_store, neuranix_checkpoint, neuranix_status
• Resources — neuranix://agent-guide, neuranix://ide-setup
• Prompts — session_start, before_task, save_decision, session_end, after_compaction, health_check

O usuário não precisa pedir para salvar ou recuperar memória.

Ciclo automático

| Momento | Tool / Prompt | |---------|---------------| | Início da sessão / após compactação | neuranix_context / session_start | | Antes de refactor, debug, review | neuranix_recall / before_task | | Após decisão, fix ou padrão | neuranix_store / save_decision | | Fim de sessão | neuranix_checkpoint / session_end | | Erro de API ou diagnóstico | neuranix_status / health_check |

Sempre passe workspace_path (absoluto) e task_context (foco da conversa).

Campos de store (v1.3.2+)

| Campo | Descrição | |-------|-----------| | type | decision, concept, code_snippet, etc. | | priority | 1 (baixa) a 5 (crítica) — regras invioláveis → 5 | | tags | Lista de tags pesquisáveis | | summary | Resumo curto opcional | | protocol_version | Tag de versão de protocolo (ex. genesis-v1) | | supersedes_id | UUID da memória obsoleta que esta substitui |

Actions no /memory (v1.3.3+)

list, update e delete via action no body (além de context, store, recall). GET /memory lista memórias do projeto.

Instalação (2 passos)

1. Cole a configuração MCP do Dashboard Neuranix
2. Reinicie o IDE

{
  "mcpServers": {
    "neuranix": {
      "command": "npx",
      "args": ["-y", "@neuranix/mcp-server"],
      "env": {
        "NEURANIX_API_URL": "https://neuranix.com.br/api/neuranix",
        "NEURANIX_API_KEY": "ak_sua_chave_aqui"
      },
      "alwaysLoad": true
    }
  }
}

Reforço opcional no repositório (todos os IDEs)

npx -y @neuranix/mcp-server setup

Grava AGENTS.md, .cursor/rules/neuranix.mdc, CLAUDE.md, .github/copilot-instructions.md, .windsurfrules.

Use --force para sobrescrever arquivos existentes.

Claude Code

claude mcp add --scope project neuranix \
  --env NEURANIX_API_URL=https://neuranix.com.br/api/neuranix \
  --env NEURANIX_API_KEY=ak_sua_chave \
  -- npx -y @neuranix/mcp-server

Prompts MCP (agente pode invocar automaticamente):

| Prompt | Uso | |--------|-----| | /mcp__neuranix__session_start | Contexto no início | | /mcp__neuranix__before_task | Recall antes de tarefa | | /mcp__neuranix__save_decision | Gravar decisão | | /mcp__neuranix__session_end | Checkpoint de fim de sessão | | /mcp__neuranix__after_compaction | Recarregar após compactação | | /mcp__neuranix__health_check | Diagnóstico de API |

Variáveis de ambiente

| Variável | Descrição | |----------|-----------| | NEURANIX_API_URL | URL base da API | | NEURANIX_API_KEY | Chave API (ak_...) — obrigatória | | NEURANIX_ENV | local para http://127.0.0.1:8000/api/neuranix | | NEURANIX_ALLOW_CUSTOM_HOST | true para hosts de dev (ngrok) |

Licença

MIT