by kocierik
Provides a Golang‑based MCP server that interfaces with HashiCorp Nomad to expose job, deployment, namespace, node, allocation, variable, volume, ACL, Sentinel policy, and cluster management via the Model Context Protocol.
Mcp Nomad Go implements an MCP server written in Go that connects to a Nomad cluster. It translates Nomad's HTTP API into Model Context Protocol calls, enabling clients—such as Claude Desktop or other MCP‑compatible tools—to manage Nomad resources programmatically.
npx -y @kocierik/mcp-nomad
NOMAD_ADDR
– Nomad HTTP API address (default http://localhost:4646
).NOMAD_TOKEN
– Optional ACL token.8080
and uses the stdio
transport unless overridden.claude_desktop_config.json
as shown in the README.stdio
(default) or sse
(Server‑Sent Events).Q: Which transport should I choose?
stdio
is ideal for local CLI usage. sse
is recommended when the server must push events to remote clients.Q: How do I expose the server over the network?
-port
flag is set to a reachable port (default 8080
) and that your firewall allows inbound traffic.Q: Can I run the server in Docker?
docker run -i --rm --network=host kocierik/mcpnomad-server:latest
Adjust NOMAD_ADDR
and NOMAD_TOKEN
via -e
flags as needed.Q: Do I need a Nomad ACL token?
NOMAD_TOKEN
.Q: How are releases managed?
npx
command above.Example variable operations:
# List variables in a namespace
list_variables namespace="my-namespace" prefix="my/path" per_page=10
# Get a specific variable
get_variable path="my/path" namespace="my-namespace"
# Create a variable
create_variable path="my/path" key="username" value="john" namespace="my-namespace"
# Delete a variable
delete_variable path="my/path" namespace="my-namespace"
To use the latest published version with Inspector:
npx @modelcontextprotocol/inspector npx @kocierik/mcp-nomad
-nomad-addr string
Nomad server address (default "http://localhost:4646")
-port string
Port for SSE server (default "8080")
-transport string
Transport type (stdio or sse) (default "stdio")
NOMAD_ADDR
: Nomad HTTP API address (default: http://localhost:4646)NOMAD_TOKEN
: Nomad ACL token (optional)https://github.com/user-attachments/assets/731621d7-0acf-4045-bacc-7b34a7d83648
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 |
npx -y @smithery/cli install @kocierik/mcp-nomad --client claude
npx @michaellatman/mcp-get@latest install @kocierik/mcp-nomad
npm install -g @kocierik/mcp-nomad
Update your claude_desktop_config.json
:
{
"mcpServers": {
"mcp_nomad": {
"command": "mcp-nomad",
"args": [],
"env": {
"NOMAD_TOKEN": "${NOMAD_TOKEN}",
"NOMAD_ADDR": "${NOMAD_ADDR}"
}
}
}
}
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}"
}
}
}
}
go get github.com/kocierik/mcp-nomad
go install github.com/kocierik/mcp-nomad
docker run -i --rm --network=host kocierik/mcpnomad-server:latest
docker run -i --rm \
-e NOMAD_ADDR=http://host.docker.internal:4646 \
kocierik/mcpnomad-server:latest
{
"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"
]
}
}
}
{
"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"
]
}
}
}
This project is licensed under the MIT License - see the LICENSE file for details.
Please log in to share your review and rating for this MCP.
{ "mcpServers": { "mcp-nomad": { "command": "npx", "args": [ "-y", "@kocierik/mcp-nomad" ], "env": { "NOMAD_ADDR": "http://localhost:4646", "NOMAD_TOKEN": "<YOUR_NOMAD_TOKEN>" } } } }
Discover more MCP servers with similar functionality and use cases
by daytonaio
Provides a secure, elastic sandbox environment for executing AI‑generated code with isolated runtimes and sub‑90 ms provisioning.
by awslabs
Specialized servers that expose AWS capabilities through the Model Context Protocol, allowing AI assistants and other applications to retrieve up‑to‑date AWS documentation, manage infrastructure, query services, and perform workflow automation directly from their context.
by awslabs
AWS MCP Servers allow AI agents to interact with and manage a wide range of AWS services using natural language commands. They enable AI-powered cloud management, automated DevOps, and data-driven insights within the AWS ecosystem.
by cloudflare
Remote Model Context Protocol endpoints that let AI clients read, process, and act on data across Cloudflare services such as Workers, Radar, Observability, and more.
by supabase-community
Enables AI assistants to interact directly with Supabase projects, allowing them to query databases, fetch configuration, manage tables, and perform other project‑level operations.
by Azure
azure-mcp is a server that implements the Model Context Protocol (MCP) to connect AI agents with Azure services. It allows developers to interact with Azure resources like Storage, Cosmos DB, and the Azure CLI using natural language commands within their development environment.
by Flux159
MCP Server for Kubernetes management commands, enabling interaction with Kubernetes clusters to manage pods, deployments, and services.
by strowk
Provides a Golang‑based server that enables interaction with Kubernetes clusters via prompts, allowing listing of contexts, namespaces, resources, nodes, pods, events, logs, and executing commands inside pods.
by jamsocket
Run arbitrary Python code securely in persistent, stateful sandboxes that remain available indefinitely.