nomad-mcp

nomad-mcp

A server that provides a set of tools for managing Nomad clusters through the MCP.

39
Stars
8
Forks
14
Releases

Overview

MCP Nomad Go is a Golang-based MCP server that connects to Nomad's HTTP API to provide tools for managing Nomad clusters through the Model Context Protocol. The server exposes facilities to browse and interact with Nomad state via the MCP, and is designed to be deployed locally or in containers. It supports integration with the MCP Inspector for browsing the latest server state, and can be used with Claude Desktop to automate interactions with Nomad through Claude. Configuration is flexible: the Nomad server address is configurable via the -nomad-addr flag (default http://localhost:4646) and the HTTP port via -port (default 8080); transport type can be stdio, SSE, or streamable-http via -transport. Environment variables NOMAD_ADDR and NOMAD_TOKEN (token optional) influence Nomad connectivity. The README provides multiple installation and deployment paths, including prebuilt binaries from GitHub releases, npm-based tooling or Smithery, and Docker images for Linux and cross-platform use. Building from source with go get and go install is supported, and Claude integration examples show how to map the MCP Nomad server in Claude's configuration.

Details

Owner
kocierik
Language
Go
License
MIT License
Updated
2025-12-07

Features

Inspector Browse Integration

Browse and inspect Nomad state via MCP using the Model Context Protocol Inspector, including support for the latest Inspector version.

Claude Integration

Use with Claude Desktop to run the MCP Nomad server through various installation options and configure via Claude's JSON.

Nomad API Connectivity

Connect to Nomad's HTTP API with configurable NOMAD_ADDR and optional NOMAD_TOKEN (ACL), enabling cluster management through MCP.

Flexible Transport for Inspector

Choose transport type (stdio, SSE, or streamable-http) to suit your runtime and tooling.

Configurable CLI Options

Command-line flags -nomad-addr, -port, and -transport provide quick customization.

Environment Variable Support

Nomad address and token can be set via NOMAD_ADDR and NOMAD_TOKEN, aligning with Nomad deployment practices.

Docker Deployment

Official Docker images make it easy to deploy in Linux, macOS, and Windows environments.

Build from Source

Go-based development workflow with go get and go install to build the MCP Nomad server from source.

Audience

DevOps EngineersManage and orchestrate Nomad clusters using MCP; inspect state via Inspector and integrate with Claude.
MCP DevelopersBuild and deploy MCP servers that connect to Nomad and support Claude integration.
Nomad OperatorsOperate Nomad clusters through MCP with a Golang-based server.

Tags

NomadMCPGoGolangNomad APIInspectorClaudeNomad clustersDocker