Golang-based MCP server connecting to Nomad with various management features.
Created 3 months ago
Golang-based MCP server connecting to Nomad with various management features.
What is Golang-based MCP server connecting to Nomad with various management features.?
This is a Golang-based MCP server that connects to Nomad, providing features for job management, deployment management, namespace management, node management, allocation management, variable management, volume management, ACL management, Sentinel policy management, and cluster management. It allows users to manage jobs, deployments, namespaces, nodes, allocations, variables, volumes, ACLs, and Sentinel policies effectively.
Documentation
Features
Example variable operations:
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"
Browse With Inspector
To use the latest published version with Inspector:
npx @modelcontextprotocol/inspector npx @kocierik/mcp-nomad
Options Available
- 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")
Environment Variables
NOMAD_ADDR: Nomad HTTP API address (default: http://localhost:4646)NOMAD_TOKEN: Nomad ACL token (optional)
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 claude
Using mcp-get
npx @michaellatman/mcp-get@latest install @kocierik/mcp-nomad
Prebuilt from npm
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}"
}
}
}
}
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-nomad
Using Docker linux
docker run -i --rm --network=host kocierik/mcpnomad-server:latest
Using Docker macos/windows
docker run -i --rm \
- e NOMAD_ADDR=http://host.docker.internal:4646 \
kocierik/mcpnomad-server:latest
For 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.
Server Config
{
"mcpServers": {
"golang-based-mcp-server-connecting-to-nomad-with-various-management-features.-server": {
"command": "npx",
"args": [
"golang-based-mcp-server-connecting-to-nomad-with-various-management-features."
]
}
}
}