oh-my-hermes MCP桥接完全指南:如何把OMH的3个本地工具暴露给MCP宿主
oh-my-hermes MCP桥接完全指南如何把OMH的3个本地工具暴露给MCP宿主【免费下载链接】oh-my-hermesAll in one plugin for Hermes Agent ⚚ the coding intelligence, a long-term memory system and model optimized workflow packages项目地址: https://gitcode.com/GitHub_Trending/ohm/oh-my-hermesoh-my-hermesOMHMCP桥接是 OMH 项目内置的 stdio 桥接器负责把 OMH 的本地能力安全地暴露给 Claude Code、Codex、OpenCode、Cursor 等 MCP 宿主。OMH 本身是面向 Hermes Agent 的一体化插件编码智能、长期记忆系统与模型优化工作流包。而这个 MCP 桥接器只暴露 3 个只读本地工具——omh_status、omh_recommend、omh_probe一条命令就能生成宿主配置片段无需任何外部服务。一、为什么 OMH MCP 桥接这么克制MCPModel Context Protocol让 AI 编程宿主可以调用外部工具。OMH 的桥接设计遵循一个核心原则能力最小化证据边界清晰。 不暴露任意 shell 命令、不触发外部 API、不派发编码执行器✅ 只提供状态查询、工作流推荐、能力探测三类只读工具✅ 每次工具调用都会在本机留下omh_mcp_observation记录且明确声明这不等于宿主真正加载了桥接这种设计在 src/mcp/bridge.py 中以claim_boundary声明边界的形式硬编码进每个返回结果让宿主侧的 AI 也不会把桥接输出误当成已执行/已验证的证据。二、快速开始一条命令生成桥接配置安装 OMH 后桥接能力随omh命令一起可用。只需两步# 1. 查看桥接清单含启动参数与工具定义 omh mcp manifest # 2. 本地试运行 stdio 服务器可选用于验证连通性 omh mcp serveomh mcp manifest会打印一份完整清单服务器启动命令omh mcp serve支持--portable可移植模式、通用mcpServers配置片段、以及 3 个工具的输入/输出 Schema。工具定义源码位于 src/mcp/bridge.py可直接对照阅读每个工具的参数约束。三、三步接入把 OMH 配置写进 MCP 宿主步骤 1选择宿主生成专属配置片段omh mcp config-recipe --host claude-code # 也支持 codex / opencode / cursor / generic不同宿主的配置格式各不相同Claude Code 用 JSON、Codex 用 TOML这条命令会自动生成对应格式的可粘贴片段并附上逐步操作说明。配方生成逻辑见 src/mcp/bridge.py。步骤 2让 setup 直接写入宿主配置可选如果不想手动粘贴可以让 OMH 直接写宿主的本地配置文件omh setup --with-mcp --mcp-host claude-code # 或 codex / opencode / cursor写入范围支持user用户级如~/.claude.json与project项目级如.mcp.json目标路径规则定义在 src/mcp/host_config.py。⚠️ 注意这只是配置证据——写文件不等于宿主已加载验证方法见下一节。步骤 3重载宿主并发起对话重启或重载宿主后在对话中直接说帮我看看 OMH 当前状态或我接下来想重构前端推荐什么工作流宿主即可调用omh_status、omh_recommend等工具获取本地数据。四、3 个工具各能做什么工具作用关键参数omh_status返回紧凑的 OMH HUD/状态载荷供宿主做状态叙述presetminimal/focused/full、limitomh_recommend根据自然语言请求推荐 OMH 工作流且不存储原始请求message、limitomh_probe返回本机能力探测数据可附 parity 矩阵与能力路线图include_parity、include_roadmapomh_recommend只保存消息长度摘要如 120 characters; raw prompt not stored原始提示词不落盘对隐私敏感场景更友好——实现细节见 src/mcp/bridge.py。五、如何验证 MCP 宿主真的加载了桥接OMH 区分配置了和真正用了两种状态验证链条如下宿主侧留痕宿主或 wrapper 观察到桥接加载/工具调用后记录证据omh mcp observe-host --host claude-code --session session-id \ --event host_load --status observed --evidence-ref host-log-ref查询会话记录omh mcp sessions列出最近的宿主观察记录JSONL 追加存储。用 probe 核对状态omh probe会把mcp_preference、mcp_bridge_server、mcp_bridge_runtime、mcp_host_session、mcp_host_config作为5 个独立能力项分别报告避免把请求过误认为已观测到架构说明见 docs/ARCHITECTURE.md。六、核心文件路径速查资料路径桥接核心实现3 工具定义 JSON-RPC 处理src/mcp/bridge.py宿主配置写入JSON/TOML 合并逻辑src/mcp/host_config.pyCLI 子命令入口manifest/config-recipe/serve/observe-host/sessionssrc/commands/mcp.py安装与 MCP 配置完整说明docs/INSTALLATION.md桥接架构与证据边界设计docs/ARCHITECTURE.md七、总结什么时候该用 OMH MCP 桥接✅ 你已安装 OMH且主力宿主支持 MCPClaude Code、Codex、OpenCode、Cursor✅ 希望在宿主对话中直接引用 OMH 的状态、工作流推荐与能力探测❌ 在 Hermes 聊天内使用时不需要——优先使用已安装的 OMH skillsMCP 桥接仅作为宿主侧的补充通道这也是omh mcp manifest中normal_hermes_surface字段的原话一句话OMH MCP 桥接 一条命令 3 个只读工具 清晰的证据边界是新手把 OMH 能力接进现有 MCP 工作流的最快、最安全的路径。【免费下载链接】oh-my-hermesAll in one plugin for Hermes Agent ⚚ the coding intelligence, a long-term memory system and model optimized workflow packages项目地址: https://gitcode.com/GitHub_Trending/ohm/oh-my-hermes创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考