hermes-fleet-mcp
Routes Docker operations (e.g., listing containers, viewing logs) across a fleet of Docker hosts via the Scotty API.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
hermes-fleet-mcp
MCP (Model Context Protocol) server that routes Docker operations across a fleet of Docker hosts via the Scotty API.
Overview
Provides two MCP tools:
fleet_route— Route a Docker operation through Scotty (Arcane MCP → target Docker host).fleet_hosts— List all known Docker hosts in the fleet.
Related MCP server: amp-mcp-server
Quick Start
Install
pip install hermes-fleet-mcpOr run from source:
pip install -e .Configure
Set environment variables (all optional):
Variable | Default | Description |
|
| Scotty API endpoint |
|
| JSON array of host identifiers |
Run
python -m hermes_fleet_mcpThe server communicates via stdio JSON-RPC.
Tool: fleet_route
Route a Docker operation through Scotty.
Parameters
Parameter | Required | Default | Description |
| Yes | — | The Docker operation to perform (e.g. "List all running containers", "Show container logs for nginx") |
| No |
| Target host identifier. Use |
| No |
| Optional context parameters (passed as additional context to Scotty) |
Examples
{
"tool": "fleet_route",
"arguments": {
"action": "List all running containers",
"host": "hostinger-01"
}
}{
"tool": "fleet_route",
"arguments": {
"action": "Show container logs for plex",
"host": "all"
}
}Tool: fleet_hosts
List all known hosts.
{
"tool": "fleet_hosts",
"arguments": {}
}Docker Deployment
docker build -t hermes-fleet-mcp .
docker run --rm -e SCOTTY_BASE_URL=http://scotty:8644/v1 hermes-fleet-mcpHermes Agent Registration
Add to ~/.hermes/profiles/<profile>/config.yaml:
mcp_servers:
fleet-mcp:
command: "python"
args: ["-m", "hermes_fleet_mcp"]
timeout: 120
connect_timeout: 15Architecture
MCP Client → hermes-fleet-mcp (stdio)
↓ POST /v1/chat/completions
Scotty (Hermes profile)
↓ Arcane MCP
Target Docker host(s)The server proxies Docker operation requests to Scotty's chat API. Scotty then routes through Arcane MCP to the appropriate Docker host(s). This means the server doesn't need direct Docker access — it delegates to the existing fleet management infrastructure.
Development
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"Run tests:
python3 tests/test_fleet_mcp.pyLicense
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Hosted MCP server for task-first delegation to remote workstations and workers.
MCP server for Riveter's enrichment, scraping, and monitoring API
MCP federation gateway: route, govern and observe agent tools across clouds and MCP servers.
MCP server for mandates, delegation, policy-gated execution, credential grants, and audit.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceGateway MCP Server - Route MCP requests intelligently to multiple backend servers.3MIT
- AlicenseAqualityDmaintenanceMCP server that wraps CubeCoders AMP to list, inspect, and control game-server instances.85MIT
- AlicenseNot gradedqualityDmaintenanceUnifies multiple MCP servers behind a single endpoint with lazy loading, auto-cleanup, Python plugins, and role-based filtering.2MIT
- AlicenseNot gradedqualityCmaintenanceAggregates multiple MCP servers into a single HTTP endpoint with tool namespacing, dashboard, and REST API for management.MIT