Neo-mcp
Neo는 AI 에이전트 구축, AI 모델 미세 조정 및 평가, ML 파이프라인과 같은 작업을 위해 다단계 작업을 계획, 연구 및 실행하는 최초의 자율 AI 엔지니어링 에이전트입니다. 코드베이스, 데이터 및 실험을 활용하여 검사 가능한 아티팩트로 더 빠르게 배포할 수 있습니다. 저장소를 분석하고, 도구와 검색을 연결하며, 학습 실행을 디버깅하고, 프로덕션 준비가 완료된 AI 워크플로우를 개발하는 데 도움을 줍니다.
문서
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>.envwith0o600permissions. - Keys are never sent to the NEO backend, written to logs, or committed to git.
neo_list_integrationsreturns provider names only, never the secret itself.
NEO Research Inc. - https://heyneo.com