https://github.com/kocierik/mcp-nomad
A nomad MCP Server (modelcontextprotocol)
https://github.com/kocierik/mcp-nomad
mcp nomad server
Last synced: 4 months ago
JSON representation
A nomad MCP Server (modelcontextprotocol)
- Host: GitHub
- URL: https://github.com/kocierik/mcp-nomad
- Owner: kocierik
- License: mit
- Created: 2025-04-20T09:39:28.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-11-24T22:49:06.000Z (7 months ago)
- Last Synced: 2025-12-07T21:16:42.678Z (7 months ago)
- Topics: mcp, nomad, server
- Language: Go
- Homepage: https://www.npmjs.com/package/@kocierik/mcp-nomad
- Size: 37.2 MB
- Stars: 39
- Watchers: 2
- Forks: 8
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp - kocierik/mcp-nomad
- awesome-mcp-servers - nomad-mcp - MCP server for managing HashiCorp Nomad clusters and workloads. (Community Servers)
- awesome-mcp-servers - **mcp-nomad** - A nomad MCP Server (modelcontextprotocol) `http` `ml` `git` `github` `monitoring` `go install kocierik/mcp-nomad@latest` (📦 Other)
- awesome-devops-mcp-servers - kocierik/mcp-nomad - MCP Server for nomad management, and analyze your cluster, application health, logs and ACL. (Cloud Infrastructure / 🐳 Container Orchestration)
- awesome-mcp-servers - Nomad MCP
- metorial-index - MCP Nomad - Manage and monitor Nomad jobs, deployments, namespaces, nodes, allocations, variables, volumes, and ACLs. Perform real-time monitoring and secure operations using token-based authentication for Nomad cluster administration and automation. (Cloud Services)
- toolsdk-mcp-registry - ❌ nomad
- awesome-mcp-security - kocierik/mcp-nomad - MCP Server for nomad management, and analyze your cluster, application health, logs and ACL. (Cloud Infrastructure / 🐳 Container Orchestration)
- awesome-nomad - kocierik/mcp-nomad - mcp-nomad is a Golang-based MCP server that connects to HashiCorp Nomad, providing comprehensive management of Nomad jobs, deployments, nodes, ACLs, and other cluster resources through the Model Context Protocol. (Infrastructure setup / Automation and Infrastructure Management)
README
Golang-based MCP server connecting to Nomad
MCP Nomad Go
Features ⚙
Browse With Inspector ⚙
Use With Claude ⚙
Contributing ↗ ⚙
About MCP ↗
## Browse With Inspector
To use the latest published version with Inspector:
```bash
npx @modelcontextprotocol/inspector npx @kocierik/mcp-nomad
```
### Options 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)
## 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
```bash
npx -y @smithery/cli install @kocierik/mcp-nomad --client claude
```
### Using mcp-get
```bash
npx @michaellatman/mcp-get@latest install @kocierik/mcp-nomad
```
### Prebuilt from npm
```bash
npm install -g @kocierik/mcp-nomad
```
Update your `claude_desktop_config.json`:
```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:
```json
{
"mcpServers": {
"mcp_nomad": {
"command": "mcp-nomad",
"args": [],
"env": {
"NOMAD_TOKEN": "${NOMAD_TOKEN}",
"NOMAD_ADDR": "${NOMAD_ADDR}"
}
}
}
}
```
### Building from Source
```bash
go get github.com/kocierik/mcp-nomad
go install github.com/kocierik/mcp-nomad
```
### Using Docker linux
```bash
docker run -i --rm --network=host kocierik/mcpnomad-server:latest
```
### Using Docker macos/windows
```bash
docker run -i --rm \
-e NOMAD_ADDR=http://host.docker.internal:4646 \
kocierik/mcpnomad-server:latest
```
### For Claude macos/windows:
```json
{
"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:
```json
{
"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.