如何用MCP扩展AI能力Hermes Desktop的MCP服务器管理完整教程【免费下载链接】hermes-desktopDesktop Companion for Hermes Agent项目地址: https://gitcode.com/gh_mirrors/her/hermes-desktopHermes Desktop是 Hermes Agent 的官方桌面伴侣应用内置的 MCP 服务器管理功能让你可以一键安装、添加、测试和启停 Model Context ProtocolMCP服务器无需手改任何配置文件即可为 AI 接入数据库、浏览器、地图等外部工具能力。本教程将带你从零完成 MCP 服务器的完整配置。为什么需要 MCP大模型本身只会说要让它真正干活——查数据库、开网页、读文件系统——需要借助外部工具。MCPModel Context Protocol就是 AI 与外部工具之间的通用插座协议对开发者写一个 MCP 服务器所有支持 MCP 的 AI 客户端都能用对用户在 Hermes Desktop 里添加一个服务器AI 就立刻获得对应能力在 Hermes Desktop 中每个 MCP 服务器有两种接入方式传输协议类型说明典型场景HTTP通过 URL 连接远程 MCP 服务云端服务、团队协作服务stdio本地启动一个命令行进程通信本地数据库、文件类工具找到 MCP 管理界面打开左侧导航的Capabilities能力面板顶部有三个页签Tools / MCP Servers / Skills。点击MCP Servers页签即可进入管理界面所有已配置的服务器以表格形式列出包含四列服务器名称、传输类型、命令/URL、启用状态。界面源码位于 Tools.tsx每一行悬停时会显示编辑、测试、删除三个操作按钮右侧还有一个独立的启用开关——关闭后该行会变暗直观区分服务器是否生效。方式一从 Hermes MCP 目录一键安装不想自己配置Hermes 提供了官方 MCP 目录Catalog收录了大量社区维护的现成服务器。在 MCP 页签点击右上角的Browse catalog按钮会跳转到Discover → MCPs页签源码见 Discover.tsx。这里列出的每个条目都带有图标、来源和安装状态点击安装后Hermes Desktop 自动下载并配置服务器需要的环境变量如 API Token会引导你填写安装完成后自动启用无需重启目录数据加载逻辑在 mcp-servers.ts 的listMcpCatalog中实现它会在本地模式和远程模式之间自动选择数据来源。方式二手动添加自定义 MCP 服务器对于目录里没有的服务点击Add server按钮打开配置弹窗1️⃣ 填写基本信息Name名称以字母或数字开头只含字母、数字、下划线或连字符且不能与已有服务器重名Transport传输选择 HTTP 或 stdio2️⃣ 按类型填写连接信息HTTP 类型只需两项URL必须以http://或https://开头Authentication可选 None / OAuth / Header 三种鉴权方式stdio 类型需要三项Command命令要执行的启动命令如npxArguments参数每行一个例如-y、modelcontextprotocol/server-githubEnvironment环境变量每行一组KEYVALUE例如GITHUB_PERSONAL_ACCESS_TOKENxxx3️⃣ 保存保存后条目立即出现在列表中。输入校验规则名称格式、URL 前缀、环境变量名合法性都定义在 mcp-servers.ts 的validateServerInput函数中不符合要求会在弹窗内直接提示。 小技巧弹窗顶部有Visual / JSON双模式切换。Visual 是字段表单JSON 是原始 Server JSON 编辑器两者实时同步。高级用户可以直接粘贴现成的 JSON 配置切换时自动互相转换见 Tools.tsx。测试连接确认 MCP 服务器真的可用添加完成后点击该行悬停出现的测试连接烧瓶图标按钮。测试会真实建立连接并拉取工具列表✅ 成功表格上方显示绿色横幅 MCP server connected. N tools found.告诉你 AI 将获得多少个工具❌ 失败显示红色错误横幅提示具体的连接错误测试逻辑在 mcp-servers.ts 的testMcpServer中实现本地模式调用hermes mcp test name命令远程模式则请求网关的/api/mcp/servers/name/test接口。启用、禁用与删除 MCP 服务器启用开关行尾的拨动开关关闭后服务器保留配置但不再被 AI 调用适合临时停用某个服务删除点击垃圾桶图标并确认配置即被移除所有操作最终都落在配置层面本地模式下每个服务器都是 profile 的config.yaml中mcp_servers块下的一条记录写入逻辑见 mcp-servers.tsRemote/SSH 远程模式下同样的一套界面会转而调用网关的/api/mcp/serversREST 接口你在本地看到的其实是远程服务器上的配置。配置生效在对话中使用新工具MCP 服务器启用后无需任何额外设置下次对话时 AI 就能自动感知并使用这些工具。下面是一个配置好工具能力后的对话界面示例常见问题快速排查Q测试连接一直失败先确认传输类型选对了URL 填了就必须选 HTTP本地命令就选 stdio。stdio 类型检查命令能否在终端手动跑通以及环境变量里的 Token 是否有效。Q提示 MCP server already exists服务器名称重复了。编辑已有服务器可原地更新编辑时改名也支持会自动处理旧条目。Q远程模式下提示 catalog 不可用说明连接的 Hermes Agent 网关版本暂不支持目录接口可改用Add server手动添加。总结需求操作路径快速接入现成能力Capabilities → MCP Servers → Browse catalog接入自建/第三方服务MCP Servers → Add server排查连接问题行内测试按钮看横幅提示临时停用某服务行尾启用开关无需删除整套功能的架构说明可在项目文档 lat.md/mcp-servers.md 中查阅核心实现分布在主进程的 src/main/mcp-servers.ts 和渲染层的 src/renderer/src/screens/Tools/Tools.tsx。掌握 MCP 服务器管理你的 Hermes Agent 就能像插上不同外设一样随时扩展出任意工作场景所需的能力。【免费下载链接】hermes-desktopDesktop Companion for Hermes Agent项目地址: https://gitcode.com/gh_mirrors/her/hermes-desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考