Neo-mcp

Neo é o primeiro agente autônomo de engenharia de IA que planeja, pesquisa e executa trabalhos de múltiplas etapas para tarefas como construir agentes de IA, ajuste fino e avaliações de modelos de IA, e pipelines de ML; usando seu código, dados e experimentos para entregar mais rápido com artefatos inspecionáveis. Ele pode raciocinar sobre seu repositório, conectar ferramentas e recuperação, depurar execuções de treinamento e ajudar você a desenvolver fluxos de trabalho de IA prontos para produção.

Ver em heyneo.com

Documentação

NEO MCP

NEO MCP connects your AI editor to NEO - an autonomous AI engineering agent - via the Model Context Protocol. Submit long-running tasks (fine-tuning, RAG pipelines, benchmarking, evals) directly from Claude Code, Cursor, Windsurf, VS Code, or any MCP-compatible editor, and get results synced back to your project folder.

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

About

NEO is an autonomous AI engineering agent that plans, researches, and executes multi-step ML and AI engineering work, including fine-tuning, quantization, benchmarking, evals, and agentic pipeline construction, using your codebase, data, and experiments.

The neo-mcp package runs a local MCP server that bridges any MCP-compatible editor to the NEO backend. Tasks run autonomously and results are written back to your workspace.

Supported editors: Claude Code, Cursor, Windsurf, VS Code, Zed, Continue, Codex CLI, Antigravity

Installation

pip install neo-mcp

If you get error: externally-managed-environment, run:

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

Quick Start (Claude Code)

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

Get your API key at: https://heyneo.com/dashboard

MCP Tools

Tool	What it does
`neo_submit_task`	Start a NEO task; returns a `thread_id`. Optional `wait_for_completion` blocks until done.
`neo_task_status`	Poll task status (`RUNNING`, `COMPLETED`, `WAITING_FOR_FEEDBACK`, etc.).
`neo_get_messages`	Read the task transcript after completion.
`neo_list_tasks`	List recent or active tasks.
`neo_send_feedback`	Reply when NEO is waiting for user input.
`neo_pause_task` / `neo_resume_task`	Pause or resume a running task.
`neo_stop_task`	Stop and tear down a task.
`neo_add_integration`	Store a provider key (GitHub, HuggingFace, Anthropic, OpenRouter, or any custom secret) locally for use in tasks.
`neo_list_integrations`	List configured providers (names only, never the secret).
`neo_test_integration`	Validate a stored key against the provider's API.
`neo_remove_integration`	Delete a stored key.

Typical flow: neo_submit_task -> poll neo_task_status -> neo_get_messages (or use wait_for_completion to skip polling).

Integrations

Give NEO access to external services by storing API keys locally once. Keys are injected as environment variables on every task run and never leave your machine.

Provider	Credential	What NEO can do with it
`github`	Personal Access Token (`ghp_...`)	Clone private repos, push, open PRs
`huggingface`	Token (`hf_...`)	Download private models and datasets
`anthropic`	API key (`sk-ant-...`)	Run Claude models inside tasks
`openrouter`	API key (`sk-or-...`)	Route through any model OpenRouter supports

Security

Keys are stored locally at ~/.neo/integrations/<provider>.env with 0o600 permissions.
Keys are never sent to the NEO backend, written to logs, or committed to git.
neo_list_integrations returns provider names only, never the secret itself.

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