xmesh

Remote MCP · Windows · macOS · Linux

让 Agent 用上你真实的开发机器

xmesh 把设备上的终端、文件和本机已有的 MCP 工具组成网格,通过标准 Remote MCP 交给 Codex、Claude Code 以及云端 Agent。每台机器运行同一个进程,局域网与 Tailnet 自动互联,需要时一键开放带 OAuth 2.1 的公网入口。

云端 / 本机 AgentCodex · Claude Code
MCP · OAuth 2.1
Gateway / Ingress聚合所有设备
LAN · Tailnet
你的设备终端 · 文件 · 本机 MCP

它能做什么

⌘

终端与命令

exec.* 执行命令,pty.* 提供可交互的伪终端会话。

⇅

文件读写与互传

fs.* 读写文件,分块上传下载并校验 SHA-256。

◎

本机 MCP 聚合

挂载设备上已有的 MCP 服务,统一以 设备名/工具 暴露。

⌗

多设备网格

LAN 与 Tailnet 共存,首选局域网,断线自动恢复。

☁

云端入口

任一节点可开启 Ingress,提供带 OAuth 2.1 的公网 MCP 端点。

⛨

权限边界

按目录 allow / deny,开发与只读两档权限,并发有租约规则。

1下载安装

Windows / macOS 桌面应用当前用户安装

选择这台设备的系统与芯片。无法确定芯片时,请打开系统「关于」查看后手动选择。

请确认设备架构。

稳定版需要系统签名验证;测试版的签名状态见对应版本清单。

安装后打开 xmesh,进入设置向导。命令行安装、SHA-256 与离线说明 →

Linux 服务器 / 工作站systemd 用户服务

安装脚本把内核和网页管理面板各装成一个 systemd 用户服务,并引导你设置工作目录、权限和管理密钥。请以普通用户运行,不要使用 sudo。

curl -fsSLO https://github.com/tzf1003/xmesh/releases/download/v0.1.0-beta.20/install-linux.sh
# 检查脚本内容后运行
bash install-linux.sh --version v0.1.0-beta.20

完成后在浏览器打开 http://127.0.0.1:7480/。只装内核加 --no-webui;网页面板需要 Node.js ≥ 22.18。Linux 安装说明 →

2或者,让 Agent 帮你安装

安装提示词

把这段提示词交给本机的 Codex 或 Claude Code。它会按当前版本的说明先检查环境,再展示安装与配置计划,等你确认后执行。

3三步连接

  1. 01

    选择用途和目录

    本机使用、多设备互联或云端 Agent;选定实际工作目录。

  2. 02

    确认权限与客户端

    开发或只读访问,选择 Codex、Claude Code,确认计划后执行。

  3. 03

    登录并验证连接

    需要时在浏览器完成登录,再从客户端发起一次真实请求。

查看计划、恢复与验证命令 →

遇到问题

安装会报告所处阶段和下一步操作。保留已校验的安装包,重试同一版本;已开始的配置可使用 job ID 恢复。

安装与连接排查失败阶段与恢复动作
Agent 文档按版本固定的安装与配置流程
llms.txt给 Agent 阅读的文档索引