Nexus - 为 AI 客户端提供受控本地工具访问的 MCP 控制平面
Nexus 是一个开源的本地 MCP 控制平面,通过带 Bearer Token 认证的 MCP Streamable HTTP,把经过授权的本地工具暴露给兼容的 AI 客户端。项目自述提供 332 个规范 MCP 工具、动作账本 WAL、Windows 计算机操作与多层级路径沙箱,采用 AGPL-3.0 许可。
Nexus 是一个开源的本地 MCP 控制平面,面向兼容 MCP 的 AI 客户端。按项目自述,它通过带 Bearer Token 认证的 MCP Streamable HTTP 暴露本地已授权的工具,让 AI 代理在配置好的工作区与执行权限范围内检查、编辑、构建、调试和编排本地工程流程。它适合希望在浏览器端 AI 聊天界面或其他 MCP 客户端与本机开发环境之间建立一层可控通道的开发者,也适合需要审计与权限边界的小团队。
项目自述采用两部分工作流:WebAgent 是可选浏览器扩展,用于兼容的网页 AI 聊天界面;Nexus 是本地服务,负责执行工作区权限并执行工具调用。README 也提醒,返回给网页 AI 聊天的工具结果可能离开本机,使用者应自行判断哪些内容会发送给第三方 AI 服务。
维护者与状态
仓库由 ysunyang4 维护,地址为 github.com/ysunyang4/Nexus。仓库创建于 2026-11-13,最后一次提交在 2026-11-18。最新 release 为 v1.3.1-r4,发布于 2026-11-13。截至 2026-11-18,仓库星标数为 395。许可证为 AGPL-3.0。
需要说明的是,项目自述提到桌面安装包是否可用要以 releases 页面的 Assets 为准,并明确提示不要假定某个平台一定存在安装包;如果没有经过验证的安装包,应改用源码构建。历史 v1.3.1 标签与 main 分支的构建结果可能不同。
主要能力
以下内容据项目 README 自述整理,未经本站独立验证。
- 332 个规范 MCP 工具:项目称全部工具在 @localbridge/protocol 中正式定义,带严格输入 schema、风险评级与自动化证据追踪,覆盖文件系统、Git 操作、命令执行、持久后台任务、LSP 代码智能、托管 worktree、浏览器自动化、Windows 计算机操作、视觉分析、文档工程、本地智能(记忆/规则/知识)、代理编排与系统发现等 24 个能力维度。
- 动作账本 WAL:据项目说明,每次关键工具执行在产生副作用前写入预写日志,支持崩溃恢复与状态重放,并通过幂等保护避免网络重连时的重复执行。
- Windows 计算机操作与视觉:项目自述结合 WinRT 原生 OCR 与 UI 可访问性树定位屏幕元素,支持多显示器控制、窗口切换、鼠标与键盘事件分发,并提供截图、图像比对与差异检查用于 UI 测试。
- 持久执行与进程隔离:README 称使用 Windows Job Objects 实施进程层级隔离、CPU 配额与内存上限,基于 node-pty 提供有状态伪终端会话,并用基于 AST 的命令风险引擎把命令分为 SAFE、CAUTION、DANGEROUS 三档,默认拦截破坏性系统调用。
- 本地智能存储:项目称提供基于 SQLite 的精确匹配与语义检索,用于持久项目记忆、团队规则、知识文档与提示模板,并包含上下文压缩器与可热重载的技能引擎。
- 多层级路径沙箱与安全:据项目说明,通过物理路径规范化把访问限制在授权项目根目录内,阻断目录穿越、符号链接与 NTFS 目录联接逃逸;MCP 客户端令牌与 Runner 守护进程令牌以 256 位熵生成并仅存 SHA-256 哈希;对 .env、密钥文件、.git 等敏感文件自动遮蔽。
使用入口
仓库地址:ysunyang4/Nexus。
据项目说明,源码构建的前置条件为 Node.js 24 及以上、pnpm 10 及以上、Rust stable。基本流程为克隆仓库、安装工作区依赖、构建核心包与应用,然后启动桌面控制中心:
git clone https://github.com/ysunyang4/Nexus.git cd Nexus pnpm install pnpm run build pnpm --filter @localbridge/desktop dev
连接 AI 客户端分三步:在桌面控制中心的 Workspace 下授权项目目录并设置访问模式(只读或读写)与执行模式(禁用、仅安全、项目代码);在 Settings 的 Tokens 中生成 MCP 客户端令牌;最后在客户端中配置 Streamable HTTP 端点 http://127.0.0.1:18080/mcp,并在请求头中带上 Authorization: Bearer 令牌。README 给出了 ChatGPT / 自定义 GPT Actions、标准 mcp_config.json 以及 Cursor、Windsurf 等客户端的配置示例。
许可与限制
许可证为 AGPL-3.0。项目 README 的许可证章节标题还提到反改名与安全免责声明,具体条款应以仓库 LICENSE 与相关文件为准。
已知边界方面,据项目说明:工具结果返回网页 AI 聊天后可能离开本机,使用者需自行评估数据外发风险;桌面安装包是否存在取决于 releases 页面实际列出的资源,不应假定各平台都有;源码构建需要 Node.js 24、pnpm 10 与 Rust stable;Windows 计算机操作相关能力依赖 Windows 平台特性。项目自述的测试规模为 190 多个测试套件、1200 多个测试,这属于维护者自述,本站未做复现。