概要
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.
