Mcp Nomad

What is Mcp Nomad?

Mcp Nomad is a Golang-based MCP server that connects to HashiCorp Nomad, a cluster scheduler. It enables LLM clients like Claude Desktop to interact with Nomad through MCP tools. The server supports multiple installation methods: prebuilt npm package, GitHub releases binary, or building from source.

How to use Mcp Nomad?

Install via npx @kocierik/mcp-nomad, or download a release binary, or build from source with Go. Configure Claude Desktop by adding the server to claude_desktop_config.json with the appropriate command and environment variables (NOMAD_ADDR and NOMAD_TOKEN). Optionally set NOMAD_REGION, NOMAD_NAMESPACE, and TLS-related env vars. The server can run on stdio (default), SSE, or Streamable HTTP transport.

Key features of Mcp Nomad

• Three installation options: npm, GitHub releases, or source build
• Supports stdio, SSE, and Streamable HTTP transport types
• Configurable via environment variables and command-line flags
• TLS support with CACERT, skip verify, and server name
• Uses official Nomad HTTP API with typed helper functions
• Safe API calls via an allow-list for direct requests

Use cases of Mcp Nomad

• Manage Nomad jobs and allocations through natural language in Claude Desktop
• Query cluster status, such as node health and allocation details
• Perform Nomad operations (stop, restart, inspect) without leaving the chat interface

FAQ from Mcp Nomad

What transport types does Mcp Nomad support?

stdio (default), SSE, and Streamable HTTP. Use the -transport flag to change.

How do I point Mcp Nomad to my Nomad server?

Set the NOMAD_ADDR environment variable or use the -nomad-addr flag. Default is http://localhost:4646.

What are the prerequisites for installing Mcp Nomad?

For the npm package, Node.js is required. The GitHub release binary has no prerequisites. Building from source requires a working Go installation.

How can I test Mcp Nomad locally?

Run the MCP Inspector with npx @modelcontextprotocol/inspector npx @kocierik/mcp-nomad. For Streamable HTTP or SSE, start the binary with -transport=sse or -transport=streamable-http and use the Inspector with the appropriate URL.

Does Mcp Nomad support authentication and TLS?

Yes. Provide a Nomad ACL token via NOMAD_TOKEN, and configure TLS with NOMAD_CACERT, NOMAD_SKIP_VERIFY, and NOMAD_TLS_SERVER_NAME environment variables.