Neo-mcp

Neo es el primer agente autónomo de ingeniería de IA que planifica, investiga y ejecuta trabajo de múltiples pasos para tareas como la construcción de agentes de IA, el ajuste fino y la evaluación de modelos de IA, y los pipelines de ML; utilizando tu base de código, datos y experimentos para entregar más rápido con artefactos inspeccionables. Puede razonar sobre tu repositorio, conectar herramientas y recuperación, depurar ejecuciones de entrenamiento y ayudarte a desarrollar flujos de trabajo de IA listos para producción.

Documentación

NEO MCP

NEO MCP conecta tu editor de IA con NEO, un agente autónomo de ingeniería de IA, mediante el Protocolo de Contexto de Modelos (MCP). Envía tareas de larga duración (fine-tuning, pipelines de RAG, benchmarking, evaluaciones) directamente desde Claude Code, Cursor, Windsurf, VS Code o cualquier editor compatible con MCP, y recibe los resultados sincronizados en tu carpeta de proyecto.


Acerca de

NEO es un agente autónomo de ingeniería de IA que planifica, investiga y ejecuta trabajos de ingeniería de IA y ML en múltiples pasos, incluyendo fine-tuning, cuantización, benchmarking, evaluaciones y construcción de pipelines agénticos, utilizando tu código, datos y experimentos.

El paquete neo-mcp ejecuta un servidor MCP local que conecta cualquier editor compatible con MCP al backend de NEO. Las tareas se ejecutan de forma autónoma y los resultados se escriben de vuelta en tu espacio de trabajo.

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


Instalación

pip install neo-mcp

Si obtienes error: externally-managed-environment, ejecuta:

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

Inicio rápido (Claude Code)

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

Obtén tu clave API en: https://heyneo.com/dashboard


Herramientas MCP

HerramientaQué hace
neo_submit_taskInicia una tarea de NEO; devuelve un thread_id. El wait_for_completion opcional bloquea hasta que termine.
neo_task_statusConsulta el estado de la tarea (RUNNING, COMPLETED, WAITING_FOR_FEEDBACK, etc.).
neo_get_messagesLee la transcripción de la tarea después de completarse.
neo_list_tasksLista tareas recientes o activas.
neo_send_feedbackResponde cuando NEO está esperando entrada del usuario.
neo_pause_task / neo_resume_taskPausa o reanuda una tarea en ejecución.
neo_stop_taskDetiene y desmantela una tarea.
neo_add_integrationAlmacena una clave de proveedor (GitHub, HuggingFace, Anthropic, OpenRouter o cualquier secreto personalizado) localmente para usarla en tareas.
neo_list_integrationsLista los proveedores configurados (solo nombres, nunca el secreto).
neo_test_integrationValida una clave almacenada contra la API del proveedor.
neo_remove_integrationElimina una clave almacenada.

Flujo típico: neo_submit_task -> consulta neo_task_status -> neo_get_messages (o usa wait_for_completion para omitir la consulta).


Integraciones

Dale a NEO acceso a servicios externos almacenando claves API localmente una sola vez. Las claves se inyectan como variables de entorno en cada ejecución de tarea y nunca salen de tu máquina.

ProveedorCredencialQué puede hacer NEO con ella
githubToken de acceso personal (ghp_...)Clonar repositorios privados, hacer push, abrir PRs
huggingfaceToken (hf_...)Descargar modelos y conjuntos de datos privados
anthropicClave API (sk-ant-...)Ejecutar modelos de Claude dentro de tareas
openrouterClave API (sk-or-...)Enrutar a través de cualquier modelo que soporte OpenRouter

Seguridad

  • Las claves se almacenan localmente en ~/.neo/integrations/<provider>.env con permisos 0o600.
  • Las claves nunca se envían al backend de NEO, se escriben en registros ni se confirman en git.
  • neo_list_integrations devuelve solo los nombres de los proveedores, nunca el secreto en sí.

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