Nomad MCP Server

A Golang - based MCP server for connecting to Nomad clusters, providing functions such as job management, node monitoring, and log viewing.

Developer tools Virtualization #Nomad management #Cluster monitoring #Job scheduling .Go

rating : 2 points

downloads : 10

update time : 2025-04-28

What is MCP Nomad Go?

MCP Nomad Go is a Model Context Protocol (MCP) server developed based on Golang, specifically designed to interact with Hashicorp Nomad clusters. It allows users to manage jobs, nodes, and resources in the Nomad cluster through natural language or structured commands.

How to use MCP Nomad Go?

You can use MCP Nomad Go in multiple ways: install the binary file directly, install via npm, use a Docker container, or build from the source code. After installation, configure the Nomad address and access token to start using it.

Applicable scenarios

Suitable for scenarios that require automated management of Nomad clusters, especially when you want to operate Nomad through a natural language interface or an AI assistant (such as Claude). It is also suitable for operation and maintenance teams that need to centrally manage multiple Nomad clusters.

Main features

List Nomad jobsView the list of all jobs running in the Nomad cluster

List Nomad nodesGet information about all nodes in the Nomad cluster

Get job statusQuery the current status of a specific Nomad job

Get allocation logsView the log output of Nomad allocations

Restart jobRestart the specified Nomad job

Get node metricsView the performance metrics of Nomad nodes

Advantages and limitations

Advantages

Provides a natural language interface, reducing the threshold for using Nomad

Supports multiple installation methods to adapt to different environments

Seamlessly integrates with AI assistants (such as Claude)

Lightweight Golang implementation with high - performance efficiency

Limitations

Requires basic Nomad knowledge to make full use of it

Some advanced Nomad functions may not be supported

Requires configuration of Nomad access permissions

How to use

Select the installation method

Choose a suitable installation method according to your environment: npm, Docker, pre - built binary, or build from source code

Configure Nomad connection

Set the NOMAD_ADDR environment variable to point to your Nomad server and configure NOMAD_TOKEN (if authentication is required)

Start the MCP server

Run the installed command or start the Docker container

Integrate with Claude (optional)

Configure Claude Desktop to use the MCP Nomad server

Usage cases

Monitor cluster health statusQuickly understand the overall health status of the Nomad cluster and the node resource usage through natural language queries

Troubleshoot failuresWhen a job fails, quickly obtain relevant logs for troubleshooting

Job managementManage Nomad jobs in batches, such as restarting a group of related services

Frequently Asked Questions

What version of Nomad is required?

How to protect access to the MCP server?

Does it support multi - cluster management?

How to update MCP Nomad Go?

Related resources

MCP official website

Learn more about the Model Context Protocol

GitHub repository

Project source code and issue tracking

Nomad documentation

Official documentation of Hashicorp Nomad

Contribution guide

How to contribute code to the project

🚀 Nomad MCP Go

A Nomad MCP server implemented in Golang, offering job management and task monitoring capabilities.

Features ⚙ Browse with Inspector ⚙ Use with Claude ⚙ Contribution Guide ↗ ⚙ Documentation Link

✨ Features

This is a Nomad MCP server implemented in Golang, providing the following features:

View and manage Nomad jobs.
Monitor the running status of tasks.
Offer a user-friendly interactive interface.

🚀 Quick Start

📦 Installation

Browse with Inspector

To browse this server using Inspector, follow these steps:

Open the Inspector interface.
Configure relevant parameters to connect to this server.
Start browsing and managing Nomad jobs.

Use with Claude

Integrating this server into the Claude environment can provide powerful task management and monitoring capabilities. Here is the integration guide:

Installation Options

Using Docker (for Linux)

docker run -i --rm --network=host kocierik/mcpnomad-server:latest

Using Docker (for macOS/Windows)

docker run -i --rm \
  -e NOMAD_ADDR=http://host.docker.internal:4646 \
  kocierik/mcpnomad-server:latest

Configuring Claude (for macOS/Windows)

Add the following configuration to config.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"
      ]
    }
  }
}

Configuring Claude (for Linux)

Add the following configuration to config.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"
      ]
    }
  }
}