MCP Nomad Go Server

A nomad MCP Server (modelcontextprotocol)

go

47

GitHub Stars

go

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "kocierik-mcp-nomad": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--network",
        "host",
        "kocierik/mcpnomad-server:latest"
      ],
      "env": {
        "NOMAD_ADDR": "http://localhost:4646",
        "NOMAD_TOKEN": "YOUR_NOMAD_TOKEN"
      }
    }
  }
}

You run a Golang MCP server that connects to Nomad, enabling you to manage and inspect MCP-enabled capabilities through straightforward tooling. This guide helps you install, run, and use the MCP Nomad Go server with both local Docker deployments and Claude-enabled workflows, so you can browse MCP data, run inspections, and integrate with Claude-backed workflows.

How to use

Start the MCP Nomad Go server locally with Docker to enable fast testing and production-like runs. You can access the Nomad-backed MCP server through the Inspector for quick browsing and debugging, or integrate it into Claude workflows for streamlined agent-based interactions.

How to install

Prerequisites you need before running the server:

Choose one of the following deployment methods and follow the exact commands.

Run the MCP Nomad Go server with Docker (Linux/macOS/Windows)

# Linux/macOS/Windows (Docker, run with network host)
docker run -i --rm --network=host kocierik/mcpnomad-server:latest

Claude-ready Docker deployment (macOS/Windows)

docker run -i --rm \
  -e NOMAD_TOKEN=secret-token-acl-optional \
  -e NOMAD_ADDR=http://host.docker.internal:4646 \
  mcpnomad/server:latest

Claude-ready Docker deployment (Linux)

docker run -i --rm \
  -e NOMAD_ADDR=http://172.17.0.1:4646 \
  -e NOMAD_TOKEN=secret-token-acl-optional \
  kocierik/mcpnomad-server:latest

Environment variables to configure Nomad access

The server can use these environment variables to connect to Nomad. Provide real values in your environment when running in production.

Using the Inspector and Claude integration

Inspector provides a quick way to browse the MCP state and endpoints exposed by the Nomad-backed server. Claude integration allows you to run MCP servers as part of Claude workflows, enabling automated, agent-backed interactions with your MCP data.

Available tools

Inspector

Browse MCP data and endpoints exposed by the Nomad-backed server for quick inspection and debugging.

Claude integration

Register and run the MCP server within Claude workflows for automated interactions.