Offers containerized deployment options for running the MCP server across different environments, with specific configuration instructions for Linux, macOS and Windows systems.
Enables interaction with HashiCorp Nomad cluster, providing comprehensive job management, deployment operations, namespace handling, node administration, allocation tracking, variable management, volume operations, ACL controls, Sentinel policy management, and cluster monitoring capabilities.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-nomadlist all running jobs in my Nomad cluster"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Browse With Inspector
To use the latest published version with Inspector:
npx @modelcontextprotocol/inspector npx @kocierik/mcp-nomadOptions Available
-nomad-addr string
Nomad server address (default "http://localhost:4646")
-port string
Port for HTTP server (default "8080")
-transport string
Transport type (stdio, sse, or streamable-http) (default "stdio")Environment Variables
NOMAD_ADDR: Nomad HTTP API address (default: http://localhost:4646)NOMAD_TOKEN: Nomad ACL token (optional)
Related MCP server: modbus-mcp
Use With Claude
https://github.com/user-attachments/assets/731621d7-0acf-4045-bacc-7b34a7d83648
Installation Options
Smithery | mcp-get | Pre-built NPM | Pre-built in Github | From sources | Using Docker | |
Claude Setup | Auto | Auto | Manual | Manual | Manual | Manual |
Prerequisite | Node.js | Node.js | Node.js | None | Golang | Docker |
Using Smithery
npx -y @smithery/cli install @kocierik/mcp-nomad --client claudeUsing mcp-get
npx @michaellatman/mcp-get@latest install @kocierik/mcp-nomadPrebuilt from npm
npm install -g @kocierik/mcp-nomadUpdate your claude_desktop_config.json:
{
"mcpServers": {
"mcp_nomad": {
"command": "mcp-nomad",
"args": [],
"env": {
"NOMAD_TOKEN": "${NOMAD_TOKEN}",
"NOMAD_ADDR": "${NOMAD_ADDR}"
}
}
}
}From GitHub Releases
Download the binary and configure Claude Desktop like so:
{
"mcpServers": {
"mcp_nomad": {
"command": "mcp-nomad",
"args": [],
"env": {
"NOMAD_TOKEN": "${NOMAD_TOKEN}",
"NOMAD_ADDR": "${NOMAD_ADDR}"
}
}
}
}Building from Source
go get github.com/kocierik/mcp-nomad
go install github.com/kocierik/mcp-nomadUsing Docker linux
docker run -i --rm --network=host kocierik/mcpnomad-server:latestUsing Docker macos/windows
docker run -i --rm \
-e NOMAD_ADDR=http://host.docker.internal:4646 \
kocierik/mcpnomad-server:latestFor Claude macos/windows:
{
"mcpServers": {
"mcp_nomad": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e", "NOMAD_TOKEN=secret-token-acl-optional",
"-e", "NOMAD_ADDR=http://host.docker.internal:4646",
"mcpnomad/server:latest"
]
}
}
}For Claude linux:
{
"mcpServers": {
"mcp_nomad": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"NOMAD_ADDR=http://172.17.0.1:4646",
"-e", "NOMAD_TOKEN=secret-token-acl-optional",
"kocierik/mcpnomad-server:latest"
]
}
}
}License
This project is licensed under the MIT License - see the LICENSE file for details.