MCP Nomad

This is a distribution of MCP server connecting to Nomad written in Golang.

Currently available:

| 💬 prompt | 🗂️ resource | 🤖 tool |

Example usage with Claude Desktop

To use this MCP server with Claude Desktop you would firstly need to install it.

You have two options at the moment - use pre-built binaries or build it from source.

Building from source

# Clone the repository
git clone https://github.com/kocierik/mcp-nomad.git
cd mcp-nomad

# install dependencies
go mod tidy

Then check if the server is working by running:

go run main.go -transport=stdio

Once built, you can proceed to add configuration to claude_desktop_config.json file:

{
  "mcpServers": {
    "mcp_nomad": {
      "command": "mcp-nomad",
      "args": [],
      "env": {
        "NOMAD_TOKEN": "${NOMAD_TOKEN}",
        "NOMAD_ADDR": "${NOMAD_ADDR}"
      }
    }
  }
}

Using from Claude Desktop

Now you should be able to run Claude Desktop and:

• See Nomad clusters available to attach to conversation as a resource
• Ask Claude to list jobs and their status
• Ask Claude to deploy and manage jobs
• Ask Claude to manage namespaces and ACLs
• Ask Claude to monitor allocations and deployments
• Ask Claude to manage nodes and their status
• Ask Claude to handle variables and volumes

Demo Operations

Here are some example operations you can perform:

1. Job Management:

   List all jobs in the default namespace
   Show me the status of job "my-service"
   Scale the "web" task group in job "my-service" to 3 instances

2. Node Management:

   List all nodes in the cluster
   Show me the status of node "node-1234"
   Enable drain mode for node "node-1234"

3. Resource Management:

   Create a new namespace called "development"
   List all variables in the system
   Show me all volumes in namespace "production"

4. ACL Management:

   Create a new ACL policy for read-only access
   List all ACL tokens
   Create a new role with specific policies