How kocierik/mcp-nomad works
MCP Nomad is a Go server that exposes Nomad operations as MCP tools and resources over stdio, SSE, or Streamable HTTP. The main workflow is an MCP client request entering the server, being dispatched to a domain tool handler, then using typed Nomad API helpers to call the Nomad HTTP API and return a formatted result. Tools cover jobs, ACLs, allocations, deployments, namespaces, nodes, logs, variables, volumes, cluster operations, and Sentinel policies; resources and prompts provide additional MCP capabilities. The source excerpts show selected registrations and calls; other domain links are documented in the README or remain unverified.
Main entry points: utils Other API Helpers · main.go Server & Transport · client_jobs.go Job API Helpers · jobs.go Job Operations
Components 22
MCP Server
- Server & Transport
main.go
Nomad Tools
- Job Operations
tools/jobs.go - ACL Operations
tools/acl.go - Allocation Operations
tools/allocations.go - Deployment Operations
tools/deployments.go - Namespace Operations
tools/namespaces.go - Node Operations
tools/nodes.go - Log Operations
tools/logs.go - Variable Operations
tools/variables.go - Volume Operations
tools/volumes.go - Cluster Operations
tools/cluster.go - Sentinel Policies
tools/sentinel.go
Nomad API Client
- Nomad Client
utils/client.go - Job API Helpers
utils/client_jobs.go - ACL API Helpers
utils/client_acl.go - Variable API Helpers
utils/client_variables.go - Node API Helpers
utils/client_nodes.go - Other API Helpers
utils
Other components
- MCP Client
- Nomad HTTP API
Connections 23
- MCP Client → Server & Transport: sends requests
README.md - Server & Transport → Job Operations: registers tools
main.go - Server & Transport → ACL Operations: registers tools
main.go - Server & Transport → Resources: registers resources
- Server & Transport → Prompts: registers prompts
main.go - Job Operations → Job API Helpers: calls
tools/jobs.go - ACL Operations → ACL API Helpers: calls
tools/acl.go - Variable Operations → Variable API Helpers: calls
tools/variables.go - Resources → Job API Helpers: reads job details
tools/resources.go - Nomad Client → Nomad HTTP API: sends HTTP requests
- Job API Helpers → Nomad HTTP API: calls API
- ACL API Helpers → Nomad HTTP API: calls API
- Variable API Helpers → Nomad HTTP API: calls API
- Node API Helpers → Nomad HTTP API: calls API
- Allocation Operations → Other API Helpers: calls
tools/allocations.go - Deployment Operations → Other API Helpers: calls
tools/deployments.go - Namespace Operations → Other API Helpers: calls
tools/namespaces.go - Node Operations → Node API Helpers: calls
- Log Operations → Other API Helpers: calls
tools/logs.go - Volume Operations → Other API Helpers: calls
tools/volumes.go - Cluster Operations → Other API Helpers: calls
tools/cluster.go - Sentinel Policies → Other API Helpers: calls
tools/sentinel.go - Prompts → Other API Helpers: uses APIs