hermes-oh-my-pi-mcp
This server acts as a bridge between Hermes and the oh-my-pi (omp) coding agent CLI, exposing two tools:
prompt: Runsompin one-shot mode with a given prompt, returning output as plain text or JSON. Supports optional parameters:cwd– working directory for context-aware executionmode– output format (textorjson)model/provider– select a specific AI model or providerprofile– use a custom profile for tailored behaviornoSession– disable session persistence for fully stateless calls
doctor: Verifies that bothompandbunare installed and accessible on the local system. No input required — useful for diagnosing environment issues before running prompts.
Provides tools for executing oh-my-pi coding tasks via the omp CLI, enabling code generation, refactoring, and analysis within the Hermes AI assistant.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@hermes-oh-my-pi-mcp prompt: write a Python script to fetch weather data"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
hermes-oh-my-pi-mcp
A tiny Hermes-friendly bridge for oh-my-pi / omp.
This repository now includes both the working MCP bridge and the full integration explanation for GitHub readers.
What this repo provides
It exposes two MCP tools:
prompt— runompin one-shot mode and return the outputdoctor— verifyompandbunare available locally
Related MCP server: @staticpayload/gemini-mcp
Why this exists
Hermes works well with MCP, plugins, and custom tools. oh-my-pi already provides a strong CLI/runtime, so this bridge lets Hermes users call it without reimplementing the agent stack.
The recommended operating model is:
User → Hermes → MCP bridge → bun → omp → resultHermes vs MCP vs Skill
Hermes: decides what to do
MCP bridge: actually calls
ompomp: performs the coding task
Skill: teaches Hermes when to prefer
ompand how to fall back when needed
In other words, the skill is helpful but optional; the MCP bridge is the execution layer.
Detailed integration guide
See the full explanation here:
That guide covers:
call structure
why MCP is the right wrapper
when a skill helps
example Hermes configuration
troubleshooting and usage policy
Release notes
Use this file to see what changed in each published version.
Requirements
Node.js 20+
ompinstalled and onPATHbuninstalled and onPATHbecauseompis Bun-based
Install oh-my-pi
npm install -g @oh-my-pi/pi-coding-agentIf the omp binary fails with bun: No such file or directory, install Bun 1.3.14+ and retry.
Local development
npm install
npm test
npm run doctorRun as an MCP server
npx hermes-oh-my-pi-mcpOr from source:
node ./src/index.jsHermes config example
Add this to Hermes MCP config:
{
"mcpServers": {
"oh-my-pi": {
"command": "npx",
"args": ["-y", "hermes-oh-my-pi-mcp"]
}
}
}If you want to point Hermes at a local checkout instead:
{
"mcpServers": {
"oh-my-pi": {
"command": "node",
"args": ["/absolute/path/to/hermes-oh-my-pi-mcp/src/index.js"]
}
}
}Verified local setup
On this machine, Hermes is actually connected to oh-my-pi and the MCP server is enabled.
The working registration looks like this:
hermes mcp add oh-my-pi \
--command node \
--args /home/ubuntu/oh-my-pi-hermes-mcp/src/index.js \
--env OMP_BIN=/home/ubuntu/.local/share/mise/installs/node/24.16.0/lib/node_modules/@oh-my-pi/pi-coding-agent/dist/cli.js \
--env BUN_BIN=/home/ubuntu/.bun/bin/bunThat setup was verified with:
hermes mcp test oh-my-piIf your machine uses different paths, keep the same shape but replace the absolute values with your own OMP_BIN and BUN_BIN locations.
Suggested skill policy
If you also want Hermes to prefer omp for coding requests, add a small skill that says:
Code generation / refactoring / analysis requests should consider
ompfirst.If the environment looks broken, run
doctorfirst.If
ompoutput is insufficient, Hermes should supplement it with its own reasoning and tools.
That skill is not required for the bridge to work; it just makes the usage pattern consistent.
Notes
The bridge runs
ompin a one-shot JSON-friendly mode and returns the text response.Set
OMP_BINif your binary is not justomp.Set
BUN_BINif Bun is installed somewhere custom.The long-form architecture and usage notes live in
docs/hermes-omp-integration.md.
Available Tools
2 toolsTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools, 'doctor' and 'prompt', have clearly distinct purposes: one checks environment setup and the other runs the main functionality. There is no overlap or confusion between them.
Both tool names are single words but do not follow a consistent verb_noun pattern. While simple and clear, they lack a predictable naming convention across the set.
With only 2 tools, the server is at the lower boundary of acceptable size. For a simple one-shot execution server, this may be appropriate, but it feels thin compared to typical MCP servers.
The tool surface covers checking availability and executing the main command, but misses other potential operations like configuration or version info, leaving minor gaps for more complex agent workflows.
Maintenance
Related MCP Connectors
Your prompt library in any MCP client: list, fetch, save and version prompt templates.
Remote MCP for JSON repair, hashing, formatting, IDs, dates, units, and other small tools.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceProvides a shared MCP SDK wrapper for building MCP servers with stdio transport, tool registration, JSON-safe responses, and environment helpers.39 npmMIT
- AlicenseNot gradedqualityFmaintenanceBridges Google's Gemini CLI to MCP-compatible AI assistants, enabling prompt execution, model listing, and raw CLI commands.20 npm1GPL 3.0
- AlicenseNot gradedqualityBmaintenanceBootstraps dev environments by installing, wiring, and verifying CLI tools and MCP servers from curated recipes, and provides scope-aware audit of MCP configurations.Apache 2.0
- AlicenseBqualityDmaintenanceWraps the copilot CLI into MCP tools, allowing third-party MCP clients to invoke Copilot through prompt and command tools.2GPL 3.0