桌面应用开发工具运维【免费下载链接】xpipeAccess your entire server infrastructure from your local desktop项目地址https://gitcode.com/GitHub_Trending/xp/xpipe点击查看免费下载XPipe 18.3 是 XPipe 迈向云端基础设施 Agent 工作流的关键版本它首次引入 MCPModel Context Protocol服务器让 Cursor 等 AI 客户端可以直接操控 XPipe 中的连接与文件系统同时落地了第一个云厂商集成Hetzner Cloud并新增本地网络扫描、多主机地址等实用能力。本文将以 18.3 更新日志为主体结合仓库源码逐项解析新功能的启用方式、配置模板、底层实现与使用要点帮助你在升级后第一时间用上这些能力。一、版本概览18.3 带来了什么XPipe 18.3 的主要变化集中在四个方面MCP 服务器XPipe 首次以 MCP 服务器形态对外开放自身能力可无缝接入 Cursor 等 AI Agent 工作流Hetzner Cloud 集成通过 hcloud CLI 自动列出云端服务器并作为 SSH 连接访问是云厂商集成的第一个落地范例网络扫描自动探测本地网络以及远程系统的所在网络中开放的 SSH 服务一键添加为连接多主机地址单个主机可配置多个地址随时快速切换。此外18.3 还包含大量 SSH、文件浏览器、终端、界面与稳定性方面的改进和缺陷修复。二、MCP 服务器把 XPipe 能力接入 AI Agent 工作流2.1 功能定位与启用方式MCPModel Context Protocol是 AI 客户端如 Cursor与外部工具之间的标准化通信协议。XPipe 18.3 内置的 MCP 服务器允许你在 Agent 化的工作流中直接调用 XPipe 的能力——例如列出所有已配置的连接、浏览远程文件系统、在远程主机上执行命令、打开终端等。需要特别注意的是MCP 服务器功能默认处于关闭状态必须在设置菜单中手动启用。从源码看这一开关在 AppPrefs.java 中定义为enableMcpServerfinal BooleanProperty enableMcpServer map(Mapping.builder() .property(new GlobalBooleanProperty(false)) // 默认关闭 .key(enableMcpServer) .valueClass(Boolean.class) .requiresRestart(false) .documentationLink(DocumentationLink.MCP) .build());启用路径为设置Settings→ MCP 分类勾选 MCP Server 开关即可。源码中还确认了一个联动行为启用 MCP 服务器会自动同时打开 HTTP APIenableHttpApi因为 MCP 服务器底层依赖 XPipe 的本地 HTTP 服务见 McpCategory.java 的监听器逻辑。2.2 认证机制API Key 与 Authorization 头MCP 服务器不是裸奔在本地端口上的所有请求都必须携带 Bearer API Key 认证。认证逻辑位于 AppMcpServer.java请求头中必须包含Authorization: Bearer apiKeyAPI Key 取自设置菜单中 API 分类下的apiKey配置项校验失败缺头、Key 错误会返回403并在 XPipe 界面弹出错误提示如果勾选了禁用 API 认证disableApiAuthentication则会跳过该检查——但建议仅在完全可信的本地环境开启。同时由于采用streamable HTTP 传输而非 SSEMCP 会话要求请求携带mcp-session-id头否则会返回400并提示Session ID required in mcp-session-id header。这一点在配置客户端时无需手动处理客户端会自动管理会话但有助于排查连接被拒类问题。2.3 各 MCP 客户端的开箱配置模板设置页内置了 5 种主流 MCP 客户端的配置模板且所有模板中的地址、端口、API Key 都是根据当前运行实例自动生成的见 McpCategory.java 的createMcpConfig绑定逻辑。模板结构如下Cursorstreamable-http{ mcpServers: { xpipe: { type: streamable-http, url: http://localhost:port/mcp, headers: { Authorization: Bearer apiKey } } } }VS Codehttp{ servers: { xpipe: { type: http, url: http://localhost:port/mcp, headers: { Authorization: Bearer apiKey } } } }Warp{ xpipe: { serverUrl: http://localhost:port/mcp, headers: { Authorization: Bearer apiKey } } }Claude Code命令行添加claude mcp add xpipe --transport http http://localhost:port/mcp --header Authorization: Bearer apiKeyGemini{ mcpServers: { xpipe: { serverUrl: http://localhost:port/mcp, headers: { Authorization: Bearer apiKey } } } }说明上述port是 XPipe 本地 Beacon 服务端口源码中通过AppBeaconServer.get().getPort()动态获取apiKey来自 API 设置页。MCP 端点统一为http://localhost:port/mcp。2.4 内置工具一览XPipe MCP 服务器注册了 14 个工具见 AppMcpServer.java 与 McpTools.java工具作用help列出所有可用工具及其说明listSystems按过滤条件列出所有可用连接名称、路径、信息、备注readFile/writeFile/createFile远程文件读取、写入、创建listFiles/findFile/getFileInfo远程目录列举、文件查找、元信息获取createDirectory远程创建目录openTerminal在 XPipe 中为指定连接打开终端runCommand在指定连接上执行命令runScript在指定连接上运行已配置的脚本toggleState切换连接的启用状态callApi调用 XPipe 本地 HTTP APIBeacon 接口返回结构化结果其中listSystems的实现细节值得注意它通过DataStorageQuery.queryEntry(filter)查询连接存储只返回可用validity usable且计入连接计数的条目并以 JSON 数组形式返回见 McpTools.java。而callApi则先在本地完成一次 Beacon 握手换取会话令牌再携带令牌调用目标 API 端点整体封装了对底层 HTTP API 的访问McpTools.java。2.5 自定义系统提示词Context ManagementMCP 服务器加载的系统提示词prompt支持个性化扩展设置页提供了Additional context文本框其内容会替换内置 prompt 中的__CUSTOM__占位符见 AppMcpServer.java。这一功能可以用于告诉 AI 你的服务器命名习惯、常用目录等从而显著提升 Agent 的操作准确性。对应配置项mcpAdditionalContext在 AppPrefs.java 中定义修改后需要重启 XPipe 生效requiresRestart(true)。三、Hetzner Cloud 集成第一个云厂商连接器18.3 引入了对 Hetzner Cloud 服务器的支持方式是检测并利用本地的 hcloud CLI 工具XPipe 会自动调用hcloud命令列出你的全部云服务器随后这些服务器即可像普通 SSH 连接一样直接访问打开终端、浏览文件、执行脚本等。从源码看XPipe 在启动时会对 hcloud CLI 进行探测并纳入外部工具体系——WebtopApp.java 中注册了HCLOUD(hetznerCloud, hcloud)见 WebtopApp.java其文档链接指向guide/hcloud见 DocumentationLink.java。这意味着使用前需要在本机安装并配置好hcloudCLI包括 API Token在 XPipe 中确认能识别到 hcloud 工具通过添加连接流程选择 Hetzner Cloud 分类XPipe 会拉取服务器清单并自动生成 SSH 连接。需要留意的是该集成属于 Professional 计划功能。官方将其定位为云厂商集成的第一个概念验证proof of concept后续版本有望扩展更多云厂商。四、网络扫描自动发现局域网内的 SSH 服务器4.1 入口与操作流程18.3 重新组织了新建菜单网络扫描的入口为New → Network scan即主界面新建菜单中的Local network scan ...。对应的菜单构建代码位于 StoreCreationMenu.javaprivate static MenuItem networkScanMenu() { var menu new MenuItem(); menu.setGraphic(new FontIcon(mdi2d-dns)); menu.textProperty().bind(AppI18n.observable(addNetwork)); menu.setOnAction(event - { ProcModuleProvider.get().createNetworkScanModal().show(); event.consume(); }); return menu; }触发后弹出网络扫描对话框设置项包括见 translations_en.propertiesTarget host目标主机要扫描哪个主机所在的网络可以是本机也可以是某个远程连接——也就是说远程系统所在网络同样可以被扫描Connection type连接类型要查找的连接类型及对应端口如 SSH/22Broadcast address广播地址用于 ping 填充在线设备列表的地址Scan results扫描结果展示探测到的系统清单勾选后一键添加为连接。4.2 底层机制网络扫描建立在 XPipe 既有的自动发现体系之上。扫描对话框由 ScanDialog.java 与 ScanMultiDialogComp/ScanSingleDialogComp 实现实际的探测动作由注册的ScanProvider完成——ScanDialogAction.java 会遍历所有ScanProvider在目标 Shell 会话中依次执行探测命令收集可添加的候选连接ScanOpportunity去重后呈现给用户确认。这也解释了为何扫描同样适用于远程系统及其网络整个探测是基于目标主机上的 Shell 执行的目标主机既可以是本地也可以是远程连接。五、主机多地址支持一机多地址快速切换18.3 允许为同一台主机配置多个地址在需要时可以快速切换例如主备 IP、内网/外网地址、机房多线 IP 等场景。这一能力在数据模型层体现为HostAddressStore接口见 HostAddressStore.java它要求实现方提供getHostAddress()配套的扩展模块中则有地址选择组件 HostAddressChoiceComp.java、地址切换存储 HostAddressSwitchStore.java 以及切换动作 HostAddressSwitchBranchProvider.java构成配置多个地址 → 连接时选择/切换地址的完整链路。实际操作时在主机编辑界面中维护地址列表随后即可在连接或操作时快速切换目标地址。六、SSH 体验改进18.3 对 SSH 相关能力做了系统性打磨更新日志列出以下要点超时选项重构重新设计 SSH 超时处理以更好地应对意外的连接中断MOTD 控制新增设置项可控制是否显示 SSH 登录时的 MOTDMessage of the Day横幅ProxyCommand 修复修复自定义连接中 SSH ProxyCommand 不执行的问题SSH agent 权限修复修复 Linux/macOS 上因权限问题导致 SSH agent 公钥设置失效的问题自定义 SSH agent 行为变更设置菜单中指定的自定义 agent socket 现在只对显式选择了自定义 SSH agent的连接生效默认的 OpenSSH agent 不再套用该设置同时修复了自定义 agent socket 路径设置不生效的问题网关用户名修复修复用户名中包含点号.时 SSH 网关gateway不可用的问题重复输密码修复修复编辑连接后某些终端连接即使之前已输入过密码仍会再次询问的问题编辑器支持扩展VsCode SSH 启动菜单新增对 VsCode Insiders 与 Trae 的支持。七、文件浏览器改进大目录传输大目录初始传输大小估算改为动态更新并实时显示避免长时间无反馈脚本参数修复通过文件选择执行脚本时参数未传递的问题Solaris 兼容修复 Solaris 系统上文件列表无法加载的问题Windows 刷新修复 Windows 上单个文件选择刷新失败的问题冲突对话框修复文件冲突对话框被截断的问题cmd 重命名修复在 cmd 中重命名失效的问题特殊字符目录名中的美元符号$现在可以正常支持首尾空格文件名带前导/尾随空格的条目现在会正确出现在文件列表中Windows 执行动作修复 Windows 上执行动作未限制特定文件类型、以及启用确认后不弹确认框的问题。八、其他体验改进macOS 字体更新 macOS 字体以提升可读性不喜欢新样式可在外观设置中切回旧字体TailscaleTailscale 连接升级为顶层条目且可通过 git 同步RDP/VNC 网关直连 RDP 与 VNC 连接现在可以指定网关gateway连接颜色新增青色cyan与紫色purple两种连接颜色图标偏好新增优先使用单色图标而非彩色变体的选项本地化新增越南语翻译本地 Shell 回退改进了本地 shell 回退处理及相关文档文档链接设置菜单中补充了更多文档链接ProxmoxProxmox 条目现在按 vmid 排序终端支持Kitty 与 WezTerm 现在也支持标签页/窗口设置选项即时同步连接颜色等小改动现在会即时同步无需手动触发临时文件清理XPipe 会更高频地清理临时文件。九、重要缺陷修复18.3 修复了一批影响稳定性的问题值得关注的有密码管理器修复密码管理器未运行时持有密码管理器身份identity会导致应用冻结的问题包管理器修复 apt、rpm 包管理器因两次下载重定向导致校验和不匹配而安装失败的问题隧道修复自动隧道重启有时导致隧道进入非法状态的问题系统识别修复 BSD 与 Solaris 系统无法被正确识别的问题性能修复打开连接选择器下拉列表时的性能问题UI修复部分界面元素在悬停时轻微位移的问题Bitwarden修复某些情况下每次都需要输入主密码的问题Linux 重启修复 Linux 上重启按钮不工作的问题许可证修复 XPipe 连续运行超过一周后许可证校验失效的问题git 仓库同步修复 git 仓库vault版本冲突无法自动解决的问题容器服务修复容器服务条目初次添加时不显示端口的问题。此外更新日志还提及大量未逐一列出的细节改动。十、结语XPipe 18.3 的意义在于打通了三条关键路径让 AI Agent 通过 MCP 直接操作你的服务器资产、让云服务器与本地 SSH 连接管理体验对齐以 Hetzner 为起点、让网络中发现与接入新主机变得更加自动。对于日常使用者多地址切换、SSH 超时/MOTD 控制、文件浏览器细节修复同样能直接提升体验。升级后建议按本文顺序依次体验 MCP 接入与网络扫描并结合 MCP 源码、MCP 设置页实现 与 网络扫描菜单实现 深入理解其工作机制。赞分享桌面应用开发工具运维【免费下载链接】xpipeAccess your entire server infrastructure from your local desktop项目地址https://gitcode.com/GitHub_Trending/xp/xpipe点击查看免费下载相关推荐Dalfox MCP 服务器实战指南将 XSS 扫描工具接入 Claude、Cursor 等 AI 客户端Dalfox MCP 服务器实战指南将 XSS 扫描工具接入 Claude、Cursor 等 AI 客户端 导读 Dalfox 不仅是一款命令行 XSS 扫描网络安全CLIQOwnNotes AI 集成实战LLM 补全、脚本扩展与 MCP 服务器接入指南QOwnNotes AI 集成实战LLM 补全、脚本扩展与 MCP 服务器接入指南 本文系统讲解 QOwnNotes 内置的 AILLM支持能力从 AI桌面应用VictoriaMetrics 与 AI 工具集成指南MCP 服务器、Agent Skills 与 AI 可观测性实战VictoriaMetrics 与 AI 工具集成指南MCP 服务器、Agent Skills 与 AI 可观测性实战 本文以仓库 docs/ai tools时序数据库数据库指标监控可观测性后端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考