mcp-nomad

# 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 ```bash # 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: ```bash go run main.go -transport=stdio ``` Once built, you can proceed to add configuration to `claude_desktop_config.json` file: ```json { "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 ```