Neo-mcp

NEO MCP

NEO MCP conecta seu editor de IA ao NEO - um agente autônomo de engenharia de IA - via Model Context Protocol. Envie tarefas de longa duração (fine-tuning, pipelines de RAG, benchmarking, evals) diretamente do Claude Code, Cursor, Windsurf, VS Code, ou qualquer editor compatível com MCP, e receba os resultados sincronizados de volta na pasta do seu projeto.

• Homepage: https://heyneo.com
• Docs: https://docs.heyneo.com/neo-mcp
• Install: pip install neo-mcp
• PyPI: https://pypi.org/project/neo-mcp/
• Tags: AI Agents, Developer Tools, Machine Learning, Task Automation, LLM, Fine-tuning

---

Sobre

O NEO é um agente autônomo de engenharia de IA que planeja, pesquisa e executa trabalhos de engenharia de ML e IA em múltiplas etapas, incluindo fine-tuning, quantização, benchmarking, evals e construção de pipelines agênticos, usando seu código, dados e experimentos.

O pacote neo-mcp executa um servidor MCP local que conecta qualquer editor compatível com MCP ao backend do NEO. As tarefas são executadas de forma autônoma e os resultados são gravados de volta no seu workspace.

Editores suportados: Claude Code, Cursor, Windsurf, VS Code, Zed, Continue, Codex CLI, Antigravity

---

Instalação

pip install neo-mcp

Se você receber error: externally-managed-environment, execute:

python3 -m pip install --user --break-system-packages neo-mcp

---

Início Rápido (Claude Code)

claude mcp add --scope user neo \
  -e NEO_SECRET_KEY=sk-v1-YOUR_KEY \
  -- python3 -m neo_mcp

Obtenha sua chave de API em: https://heyneo.com/dashboard

---

Ferramentas MCP

Ferramenta	O que faz
neo_submit_task	Inicia uma tarefa NEO; retorna um thread_id. O wait_for_completion opcional bloqueia até a conclusão.
neo_task_status	Consulta o status da tarefa (RUNNING, COMPLETED, WAITING_FOR_FEEDBACK, etc.).
neo_get_messages	Lê a transcrição da tarefa após a conclusão.
neo_list_tasks	Lista tarefas recentes ou ativas.
neo_send_feedback	Responde quando o NEO está aguardando entrada do usuário.
neo_pause_task / neo_resume_task	Pausa ou retoma uma tarefa em execução.
neo_stop_task	Interrompe e encerra uma tarefa.
neo_add_integration	Armazena uma chave de provedor (GitHub, HuggingFace, Anthropic, OpenRouter, ou qualquer segredo personalizado) localmente para uso em tarefas.
neo_list_integrations	Lista provedores configurados (apenas nomes, nunca o segredo).
neo_test_integration	Valida uma chave armazenada contra a API do provedor.
neo_remove_integration	Exclui uma chave armazenada.

Fluxo típico: neo_submit_task -> consulte neo_task_status -> neo_get_messages (ou use wait_for_completion para evitar a consulta).

---

Integrações

Dê ao NEO acesso a serviços externos armazenando chaves de API localmente uma única vez. As chaves são injetadas como variáveis de ambiente em cada execução de tarefa e nunca saem da sua máquina.

Provedor	Credencial	O que o NEO pode fazer com ela
github	Personal Access Token (ghp_...)	Clonar repositórios privados, fazer push, abrir PRs
huggingface	Token (hf_...)	Baixar modelos e datasets privados
anthropic	API key (sk-ant-...)	Executar modelos Claude dentro das tarefas
openrouter	API key (sk-or-...)	Roteamento por qualquer modelo suportado pelo OpenRouter

---

Segurança

• As chaves são armazenadas localmente em ~/.neo/integrations/<provider>.env com permissões 0o600.
• As chaves nunca são enviadas ao backend do NEO, gravadas em logs ou commitadas no git.
• neo_list_integrations retorna apenas os nomes dos provedores, nunca o segredo em si.

---

NEO Research Inc. - https://heyneo.com