MCP Nomad Go

MCP Nomad Go is an MCP server that connects AI assistants to HashiCorp Nomad clusters. Written in Go, it allows DevOps engineers, site reliability engineers, and system administrators to inspect, manage, and troubleshoot Nomad infrastructure through natural language prompts. The server interacts directly with Nomad's HTTP API, providing access to cluster resources including jobs, deployments, nodes, and allocations. Users can query the operational state of their orchestration workloads, manage task groups, and perform cluster lifecycle operations across diverse environments. MCP Nomad Go supports communication over standard input/output (stdio), server-sent events (SSE), or streamable HTTP, making it adaptable to local desktop clients like Claude Desktop or detached remote environments. By translating infrastructure operations into standardized Model Context Protocol tools, it enables automated monitoring and targeted intervention for Nomad-based application deployments without requiring manual CLI interactions or context switching to external dashboards.

Category: Cloud & Infrastructure

Tags: cluster, deployment, hashicorp, nomad, orchestration

Visit MCP Nomad Go

How to install and configure MCP Nomad Go

1. Ensure Node.js is installed on your system to run the package via npx, or install the CLI globally using npm install -g @kocierik/mcp-nomad. 2. Open your claude_desktop_config.json configuration file. 3. Add the server entry under the mcpServers object: json { "mcpServers": { "mcp_nomad": { "command": "npx", "args": ["-y", "@kocierik/mcp-nomad"], "env": { "NOMAD_TOKEN": "${NOMAD_TOKEN}", "NOMAD_ADDR": "${NOMAD_ADDR}" } } } } 4. Provide your actual Nomad cluster address and access token in the env variables or through system environment variables. 5. Restart Claude Desktop to load the MCP Nomad Go server.

What you can do with MCP Nomad Go

• Querying running jobs and active task allocations across multi-region Nomad clusters to diagnose workload failures. - Checking node status, availability, and resource utilization to evaluate Nomad cluster health during operational incidents. - Inspecting recent deployment statuses and monitoring rollouts directly through Claude Desktop without switching to the Nomad CLI. - Stopping problematic allocations or initiating targeted interventions on specific jobs using conversational AI prompts. - Testing Nomad API interactions and MCP tool calls locally using the official Model Context Protocol Inspector tool.

Key facts

• Open Source
• https://github.com/kocierik/mcp-nomad
• Cloud & Infrastructure, DevOps, CI/CD & Version Control
• cluster, deployment, hashicorp, nomad, orchestration

Part of MCP Servers

How do I install MCP Nomad Go?

You can run MCP Nomad Go without a prior manual download using npx by executing npx -y @kocierik/mcp-nomad. Alternatively, install it globally through npm with npm install -g @kocierik/mcp-nomad, download pre-built binaries directly from GitHub releases, or build it from source using the go install command with the kocierik/mcp-nomad repository.

What can MCP Nomad Go do?

MCP Nomad Go allows AI clients to interact with HashiCorp Nomad clusters. It provides tools to inspect jobs, track deployment progress, view node configurations, manage allocations, and execute operations against the Nomad HTTP API across configured namespaces and regions.

Which MCP clients work with MCP Nomad Go?

MCP Nomad Go works with Claude Desktop by configuring the command in the claude_desktop_config.json file. It also supports debugging via the MCP Inspector and can be integrated with any other client that supports standard input/output, SSE, or streamable HTTP transports.

What environment variables does MCP Nomad Go require?

The server uses NOMAD_ADDR to define the Nomad HTTP API address, which defaults to http://localhost:4646. It accepts NOMAD_TOKEN for authentication, NOMAD_REGION and NOMAD_NAMESPACE for routing, and supports TLS settings including NOMAD_CACERT, NOMAD_SKIP_VERIFY, and NOMAD_TLS_SERVER_NAME.

Is MCP Nomad Go open source?

Yes, MCP Nomad Go is open source software published under the MIT License. The complete source code, release binaries, and documentation are publicly hosted in the kocierik/mcp-nomad repository on GitHub.