Neo — AI/ML Engineering

Neo MCP — 无需离开编辑器，开展 AI 工程

留在 Claude Code、Cursor 或 Codex 中，将 AI/ML 工作交给 Neo——这位自主 AI 工程师可以根据通俗易懂的请求，规划、构建、运行和评估完整工作流。 neo-mcp 是 Model Context Protocol 服务，可将 Neo 接入你已在使用的 AI 编码工具，让你无需切换标签页：让 Agent 将任务交给 Neo，本地守护进程便会将生成的代码、模型、指标和报告直接写入你的代码库——一切都在你的机器上完成，不会远程存储任何内容。

Neo 专为 AI 工程优化，而非通用编码助手，因此它在 ML、大模型和数据工作流方面比通用编码 Agent 更深入。

📚 文档： https://docs.heyneo.com/neo-mcp · 🔑 获取 API 密钥： Neo 控制面板

MCP 带来的可能

• 🧩 留在你的编辑器中 — 在 Claude Code、Cursor、VS Code（Copilot）、Windsurf、Zed、Continue 或 Codex 中使用 Neo。无需安装新应用，也无需切换上下文。
• 🔬 更深入 — 针对 AI/ML 优化的自主规划、实验、评估和迭代，超越通用编码 Agent 的能力。
• 💾 本地优先 — 所有输出文件都会写入你的机器；不会远程存储任何内容。

使用 Neo 可以构建什么

• 🤖 生成式 AI 和大模型 — RAG 与语义搜索、Agent 与聊天机器人、微调（Llama、Qwen、Gemma）、文档分析
• 🧠 ML 与深度学习 — PyTorch / TensorFlow / scikit-learn 训练、架构搜索、评估
• 📊 数据科学与分析 — EDA、特征工程、预测、细分、A/B 测试、报告
• 👁️ 计算机视觉 — 图像分类、目标检测、OCR
• 🎤 语音与音频 — 语音转文本、文本转语音、音频分类
• 🔌 使用你自己的密钥 — GitHub、HuggingFace、Anthropic、OpenRouter、OpenAI、AWS S3、Weights & Biases、Kaggle——密钥存储在本地，并作为环境变量注入

适用于希望获得成果而非样板代码的数据科学家、ML 和大模型工程师、分析师、研究人员及产品经理。

---

安装

pip install neo-mcp

需要在 Linux、macOS 或通过 WSL 使用的 Windows 上安装 Python 3.11+。有意不支持在原生 Windows cmd.exe/PowerShell 中运行，因为 Neo 命令使用 POSIX shell 和容器路径语义。

提示： 使用 pipx install neo-mcp 可在隔离环境中安装，避免与项目的虚拟环境发生冲突。

---

在编辑器中使用 Neo

Neo 可在所有主流的、支持 MCP 的 AI 编辑器中运行——按下方说明完成一次设置即可。请将 sk-v1-YOUR_KEY 替换为你的实际密钥。

---

Claude Code

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

运行后，请启动新的 Claude Code 会话。Neo 工具会在会话启动时加载。

作用范围选项： --scope user（全局，推荐） · --scope project（在当前代码库中写入 .mcp.json） · --scope local（仅此机器）

验证是否已注册：

claude mcp list

---

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "neo": {
      "command": "neo-mcp",
      "env": {
        "NEO_SECRET_KEY": "sk-v1-YOUR_KEY"
      }
    }
  }
}

编辑后重启 Cursor。

---

Windsurf

~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "neo": {
      "command": "neo-mcp",
      "env": {
        "NEO_SECRET_KEY": "sk-v1-YOUR_KEY"
      }
    }
  }
}

编辑后重启 Windsurf。

---

VS Code（GitHub Copilot）

工作区根目录中的 .vscode/mcp.json（需要 VS Code 1.99+）：

{
  "servers": {
    "neo": {
      "type": "stdio",
      "command": "neo-mcp",
      "env": {
        "NEO_SECRET_KEY": "sk-v1-YOUR_KEY"
      }
    }
  }
}

---

Zed

~/.config/zed/settings.json：

{
  "context_servers": {
    "neo": {
      "source": "custom",
      "command": {
        "path": "neo-mcp",
        "args": [],
        "env": {
          "NEO_SECRET_KEY": "sk-v1-YOUR_KEY"
        }
      }
    }
  }
}

---

Continue.dev

~/.continue/config.json：

{
  "mcpServers": [
    {
      "name": "neo",
      "transport": {
        "type": "stdio",
        "command": "neo-mcp",
        "env": {
          "NEO_SECRET_KEY": "sk-v1-YOUR_KEY"
        }
      }
    }
  ]
}

---

OpenAI Codex CLI

~/.codex/config.json：

{
  "mcpServers": {
    "neo": {
      "command": "neo-mcp",
      "env": {
        "NEO_SECRET_KEY": "sk-v1-YOUR_KEY"
      }
    }
  }
}

---

工具

工具	描述
neo_submit_task	提交会在本地造成破坏性影响的 AI/ML 任务；每个工作区只能有一个活跃所有者。
neo_list_tasks	列出运行中和近期的任务 — 自动重新连接轮询器。
neo_task_status	显示精简的实时后端状态；遥测数据不能作为独立证据。
neo_get_messages	在任务 COMPLETED 时读取完整任务输出。上限约为 20 000 个令牌。
neo_send_feedback	Neo 提问时回复（WAITING_FOR_FEEDBACK）。
neo_pause_task	暂停运行中的任务。
neo_resume_task	恢复已暂停的任务。
neo_stop_task	永久停止并清理任务。
neo_list_integrations	列出已存储的第三方 API 密钥（仅名称 — 绝不显示密钥值）。
neo_add_integration	注册 GitHub PAT / HuggingFace 令牌 / Anthropic 密钥 / OpenRouter 密钥，供 Neo 任务作为环境变量使用。
neo_test_integration	调用提供商的 API，确认已存储的密钥仍然有效。
neo_remove_integration	从此机器删除已存储的密钥。
neo_get_execution_evidence	读取有界、哈希链式的本地执行观察记录。
neo_verify_task	使用明确的文件断言和验收命令验证本地文件。

集成工具会在本地存储凭据（存储在 ~/.neo/integrations/ 下的文件中，权限为 0o600，或使用设置了 NEO_INTEGRATIONS_BACKEND=keyring 的操作系统密钥环）。密钥绝不会离开你的机器。完整指南请参阅 docs/INTEGRATIONS.md。

---

环境变量

变量	必需	描述
NEO_SECRET_KEY	是	你的 Neo API 密钥（sk-v1-...），可从 Neo 控制面板获取
NEO_DEPLOYMENT_ID	否	固定使用特定的部署 UUID（默认自动生成并持久化）
NEO_WORKSPACE_DIR	否	覆盖工作目录（在 Docker 中很有用）
NEO_READ_ONLY	否	true — 仅提供状态、消息、任务/证据读取、集成测试/列表和 BYOK 列表工具；拒绝所有修改和验证命令
NEO_INIT_CHAT_TIMEOUT_SECONDS	否	提交超时时间（秒）；默认值为 60，与生产环境中的 VS Code 客户端保持一致
NEO_POLLER_READY_TIMEOUT_SECONDS	否	本地守护进程建立后端轮询连接前的最长等待时间；默认值为 15

---

故障排除

症状	解决方法
neo-mcp: command not found	重新运行 pip install neo-mcp，并使用 which neo-mcp 检查 PATH
注册后未显示工具	打开新会话 — MCP 工具会在会话开始时加载，而不是在会话中途加载
Invalid API key (401)	在 Neo 控制面板中重新检查密钥
Trial or quota ended (403)	在 Neo 控制面板中充值
已提交任务，但没有写入文件	守护进程启动失败 — 运行 neo-mcp doctor 进行诊断
状态卡在 RUNNING	调用 neo_task_status 检查；运行 neo-mcp status 检查守护进程