DevSpace

在本机自托管 MCP 服务器,让 ChatGPT 等客户端直接读写、搜索并运行你本地项目中的代码。

Star 数
★ 5.3k
最近更新
9 天前
License
MIT
主语言
TypeScript

30 秒速览

运行形态
命令行工具MCP 服务器自托管服务
可在哪里用
兼容但需适配ChatGPTClaude Code · Claude.ai · OpenAI API(部分支持)
费用
软件免费,模型调用费用自付
上手难度
中 · 需要几步配置
开始前需要
Node.js >=22.19 <27npmGitBash 兼容 shellCloudflare Tunnel、ngrok、Pinggy、Tailscale Funnel 或其他反向代理Shell / 命令行网络访问本地文件系统MCP Server
典型场景
个人开发者在 ChatGPT 中描述需求,希望它直接在自己真实仓库里改代码、跑测试,而不是把文件上传到第三方。
不适合
  • 只使用 Windows PowerShell 或 cmd.exe、不打算安装 Git Bash 或 WSL 的团队
  • 希望完全不知道也不管理公网隧道与密码审批的用户
  • 不愿让云端模型在本地项目里执行 shell 命令的团队

这个 Agent 能做什么,适合哪些场景?

DevSpace 是一个自托管的 MCP 服务器,通过 npm 包 @waishnav/devspace 提供 CLI,让你把 ChatGPT、Claude 或其他 MCP 客户端安全地接到自己机器上的真实项目目录。你在本机运行 devspace init 与 devspace serve,用自己控制的隧道(Cloudflare Tunnel、ngrok、Pinggy、Tailscale Funnel 或其它反向代理)把 /mcp 端点暴露出去,客户端连接时需要通过 Owner 密码审批。连接后客户端可以打开被允许的根目录作为工作区,读取、写入、编辑文件,搜索代码,运行测试与构建命令,并借助隔离的 Git worktree 并行开多个编码会话。同一个 /mcp 端点支持 2026-07-28 的按请求协议,并自动兼容 2025 年代的旧客户端,无需手动选择协议模式。产品以 MIT 许可开源,运行需要 Node >=22.19 <27、npm、Git 与 Bash 兼容 shell;Windows 需配合 Git Bash、WSL、MSYS2 或 Cygwin。

DevSpace 以 CLI 形式安装(npm install -g @waishnav/devspace),devspace init 收集使用场景(ChatGPT、编码代理或两者)、可作为子代理调用的本地代理、允许打开的项目目录,以及隧道提供的公共 HTTPS 基址;devspace serve 启动本地 MCP 端点,默认 http://127.0.0.1:7676/mcp。客户端连接时,DevSpace 弹出 Owner 密码审批页,密码在初始化时打印并存于 ~/.devspace/auth.json。通过审批后,客户端可把某个允许根目录下的项目当作工作区打开,并调用工具读写、编辑文件,搜索代码、检查目录,执行 shell 命令(测试、构建、git、包脚本),使用隔离 Git worktree 并行会话,读取 AGENTS.md 与 CLAUDE.md 的项目指令,发现本地技能目录中的技能,并在兼容 ChatGPT Apps 的宿主中显示工具卡片与变更摘要。devspace doctor 用于自检本地环境。

  1. 个人开发者在 ChatGPT 中描述需求,希望它直接在自己真实仓库里改代码、跑测试,而不是把文件上传到第三方。
  2. 团队已有 Claude 或其他 MCP 客户端,想用统一的自托管端点让多个代理访问同一台开发机上的项目目录。
  3. 需要在同一仓库上并行试几种实现方案时,用隔离 Git worktree 让多个编码会话互不干扰。
  4. 维护带 AGENTS.md 或 CLAUDE.md 项目规范的老项目,希望接入的代理自动遵循仓库内约定。
  5. 远程办公或使用笔记本时,通过自己掌握的隧道把本地开发环境临时开放给 ChatGPT 会话,用完即关。

如何安装或部署这个 Agent?

确认 Node 版本在 >=22.19 且 <27,并已安装 npm、Git 与 Bash 兼容 shell(Windows 上建议 Git Bash 或 WSL)。然后全局安装并初始化:

devspace init

不想全局安装时可直接运行:

npx @waishnav/devspace init

初始化会询问使用场景(ChatGPT、编码代理或两者)、可作为子代理调用的代理;若选择 ChatGPT,还会询问允许打开的项目目录和隧道的公共 HTTPS 基址(填不带 /mcp 的来源地址,例如 https://your-tunnel-host.example.com)。安装后可用以下命令自检:

devspace doctor

如何使用这个 Agent?

先在本地启动你选择的反向代理隧道(Cloudflare Tunnel、ngrok、Pinggy、Tailscale Funnel 等),再启动服务:

devspace serve

在 MCP 客户端中配置公共端点(注意带 /mcp):

https://your-tunnel-host.example.com/mcp

本地直连时使用默认端点:

http://127.0.0.1:7676/mcp

客户端首次连接会打开 Owner 密码审批页,输入 devspace init 打印的密码(也保存在 ~/.devspace/auth.json)完成授权,然后让客户端打开一个允许根目录下的项目作为工作区即可开始读写与运行命令。若只面向编码代理,初始化结束时还会打印一条 skills 命令,由 Skills CLI 完成接入安装。

这个 Agent 有哪些优点和局限?

优点
  • 自托管架构:代码留在本机,只通过你自己控制的隧道与 Owner 密码审批对外暴露。
  • 同一 /mcp 端点同时服务 2026-07-28 按请求协议与 2025 年代旧客户端,无需配置协议模式。
  • 工具面覆盖完整编码闭环:读写编辑文件、搜索、执行 shell、隔离 Git worktree 并行会话。
  • 会读取项目内 AGENTS.md 与 CLAUDE.md 指令,并发现本地技能目录,便于接入既有仓库约定。
  • MIT 许可开源,提供 devspace doctor 自检与 devspace serve 单命令启动。
局限
  • 需要自己准备并维护公共 HTTPS 隧道与 Owner 密码,属于多步骤部署。
  • Windows 上仅支持 PowerShell 或 cmd.exe 的环境目前不可用,必须安装 Git Bash 或 WSL。
  • 运行时绑定 Node >=22.19 <27、Git 与 Bash 兼容 shell,版本窗口较窄。
  • 连接后的客户端在已打开工作区内拥有 shell 执行能力,安全边界依赖你选定的根目录与信任判断。
  • 子代理调用、ChatGPT Apps 工具卡片等能力依赖具体宿主,换客户端需重新验证。

这个 Agent 与同类方案有什么区别?

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
DevSpace 当前 50 · 缺口较多 命令行工具免费 + 模型费 ★ 5.3k 9 天前 TypeScript ChatGPT
wcgw 本地编码终端 45 · 缺口较多 MCP 服务器免费 + 模型费 ★ 678 1 个月前 Python Claude.ai
Aster 77 · 表现良好 命令行工具免费 + 模型费 ★ 131 3 天前 Rust OpenAI API
Remembra Relay 72 · 存在缺口 Agent 插件 / 技能免费版 + 付费版 ★ 16 10 天前 Python Claude Code

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
50/ 100 五分制 2.5 / 5
信任安全 14/29
可靠稳定 6/14
适用触发 10/18
规范维护 10/18
有效结果 7/13
证据核验 3/8
查看各维度的扣分理由
信任安全14 / 29 · 2.4/5

安全模型文档明确给出文件系统白名单、Owner 密码 OAuth 审批、Host 头白名单、shell 权限边界与 artifact 下载的 fail-closed 处理,least_privilege 与 user_confirmation 有实质支撑(2)。但 shell 工具按设计可执行任意本地命令,worktree 明确声明不是安全边界,external_effects 缺乏对破坏性操作的确认/恢复机制(1)。依赖面庞大且含多个原生/第三方 SDK,仅靠 overrides 固定少数传递依赖,未见漏洞审计证据,dependency_security 记 1。rollback 仅提及 worktree 与配置迁移备份,缺少对文件编辑/命令副作用的回滚(1)。source_attribution 仅 README 自述作者,无发布者验证(1)。

可靠稳定6 / 14 · 2.1/5

README、configuration、security 三处对端点、端口、配置键、环境变量迁移的描述基本一致(2)。但依赖版本大量使用 ^ 浮动范围,且含 better-sqlite3、koffi、node-pty 等原生模块,跨平台可用性存在风险,dependency_availability 记 1。failure_messages 仅在配置迁移处提到 actionable error,整体错误处理未见系统说明(1)。

适用触发10 / 18 · 2.8/5

面向 ChatGPT/Claude 等 MCP 客户端与编码代理,场景描述清晰(2)。capability_boundaries 明确列出工具集、codex/claude 两种模式与不支持 PowerShell(2)。trigger_precision 依赖自然语言与 MCP 工具调用,无精确触发规则说明(1)。environment_fit 给出 Linux/macOS/Windows 支持矩阵与 doctor 命令(2)。

规范维护10 / 18 · 2.8/5

文档结构清晰,含 setup/configuration/security/gotchas 等分册(2)。安装步骤完整含 Node 版本与 pnpm 固定(2)。naming_stability 存在 v1.0→v1.1 环境变量大规模移除与配置结构变更,稳定性一般(1)。examples_and_faq 有配置示例但缺 FAQ(1)。known_limitations 明确列出平台限制与安全边界(2)。LICENSE 为完整 MIT(3)。versioning_changelog 有发布工作流与迁移说明,但无独立 CHANGELOG(1)。maintenance_responsibility 为个人维护者,发布者未验证(1)。

有效结果7 / 13 · 2.7/5

output_usability 提供工具卡片、变更摘要与明确工作流(2)。marginal_value 将本地编码能力接入 ChatGPT 有实际价值(2)。cost_benefit 需自建隧道、管理密码与信任客户端,运维成本较高(1)。

证据核验3 / 8 · 1.9/5

claim_traceability 多数安全声明指向文档但无代码级引用(1)。cross_source_corroboration README 与 docs 相互印证但无独立第三方验证(1)。fact_inference_separation 文档区分了设计意图与限制,但部分安全声明(如 descriptor-relative 操作)无法从所给文件核实(1)。

风险与缓解建议
  • shell 工具按设计可执行任意本地命令,worktree 不是安全边界,连接客户端应视为可信编码伙伴。
  • 依赖面庞大且含原生模块与浮动版本范围,跨平台安装与供应链风险需自行审计。
  • 发布者身份未经验证,维护责任与更新路径依赖单一作者。
  • v1.0→v1.1 环境变量大规模移除,升级需手动迁移配置。
  • 部分安全声明(如 descriptor-relative 文件操作)无法从所给文件核实,需代码级审查。
证据充分度:低 评估于 2026年10月21日 审查版本 531d3f973f09
查看完整评分方法 →

常见问题

DevSpace 会把我的代码上传到第三方吗?
按 README 描述,它在你的机器上运行,只通过你自己控制的隧道暴露 /mcp 端点,连接需 Owner 密码审批;代码读写与命令执行都发生在本地已打开的根目录内。但客户端一侧仍是云端模型,会话内容会随对话发往模型提供方。
需要什么环境才能跑起来?
需要 Node >=22.19 <27、npm、Git 与 Bash 兼容 shell。Linux 与 macOS 直接支持;Windows 需使用 Git Bash、WSL、MSYS2 或 Cygwin Bash,仅 PowerShell 或 cmd.exe 尚不支持。可用 devspace doctor 检查本地环境。
连接时如何完成授权?
devspace init 会打印 Owner 密码并保存到 ~/.devspace/auth.json;客户端连接 /mcp 时 DevSpace 打开 Owner 密码审批页,输入该密码即完成授权,密码应保持私密。
能否同时给 ChatGPT 和编码代理用?
初始化时可以选择 ChatGPT、编码代理或两者。ChatGPT 场景还需要指定允许打开的项目目录与公共隧道地址并运行 devspace serve;仅编码代理场景不询问这两项,本地命令使用当前 Git 项目或当前目录。
使用它会不会违反 OpenAI 的使用政策?
README 援引 OpenAI 使用政策与服务条款(截至 2026 年 6 月)说明,把 DevSpace 作为 MCP 连接器属于标准自定义应用/连接器配置,编写或运行代码不是受限用途;但账户合规取决于你的实际使用方式。
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关 Agents