智能体基础设施 / 自托管架构

Local MCP

一个入口,让智能体在多台机器上工作。

我的角色

设计、开发与部署

时间

2026

方向

MCP · OAuth / PKCE · macOS / Linux

Local MCP 是连接网页 AI 与用户所控制机器的工具网关。它通过统一的 MCP 入口,把文件、命令和终端操作路由到明确选择的 macOS 或 Linux 执行端。

具体产出

面向自托管的多机器智能体基础设施,支持身份验证、会话隔离和构建版本校验。我已在自己的六节点环境中部署验证;公开安装包与多用户托管服务尚未发布。

本页目录+

01

把控制面和执行端分开

Gateway 处理身份验证、机器选择与稳定的工具目录;执行端负责实际文件、命令和终端操作。这样,选择在哪台机器工作成为明确的输入,而不是隐藏在工具描述中的假设。

  1. 01网页智能体
  2. 02认证与工具路由
  3. 03macOS / Linux 执行端

02

身份、会话和版本都需要边界

我实现 OAuth / PKCE 认证与基于认证上下文的会话归属,避免不同客户端共享执行状态。构建来源校验会拒绝与预期版本不一致的执行端,而不是悄悄放宽检查。

  • 控制面与执行端解耦。
  • 不同客户端的会话隔离。
  • 稳定的工具发现与构建版本校验。

03

命令执行只是开始

长任务还需要可持续读取的输出、持久任务处理与生命周期清理。我处理了 UTF-8 安全分页、工具目录稳定性和资源清理,并用实际命令与 PTY 验收跨平台行为。

04

自托管,而不是共享我的机器

产品方向是让用户连接自己拥有或授权的机器,而不是让陌生人访问我的执行环境。2026 年 10 月的项目记录确认了六节点实际命令执行;这个验证范围不等于已提供公众托管服务。

公开可安装版本还需要完成打包、凭据隔离、受限默认权限和部署文档。现阶段可以阅读架构与工程案例,不能据此注册或接入生产网关。

想交流项目、研究,或一起做点什么?

peterhpywk@gmail.com