hermes-cli-mcp
v1.0.1
Published
MCP server wrapping the Hermes Agent CLI — exposes ping, ask-hermes, search-web, and write-file tools to any MCP client
Downloads
45
Maintainers
Readme
hermes-cli-mcp
MCP server wrapping the hermes (Meta Hermes Agent) CLI. Exposes ping, ask-hermes, search-web, and write-file to any MCP client (Claude Code, Kilo, OpenCode, Codex, Cline, etc.).
Prerequisites
- Bun v1.0+
hermesinstalled and on PATH (or setHERMES_PATHenv var)
Installation
npm install -g hermes-cli-mcp
# or
bunx hermes-cli-mcpRegister with Claude Code
claude mcp add hermes-mcp -- npx hermes-cli-mcpEnvironment Variables
| Variable | Default | Description |
|----------|---------|-------------|
| HERMES_PATH | hermes | Path to the hermes binary |
| HERMES_TIMEOUT_MS | 300000 | Request timeout in ms |
| HERMES_WORKSPACE_ROOT | process.cwd() | Workspace root for file operations |
Tools
| Tool | Description |
|------|-------------|
| ping | Health check — shows version and binary path |
| ask-hermes | Run a prompt non-interactively |
| search-web | Web search via hermes |
| write-file | Write files within workspace |
License
MIT
