mcp-nomad

Verwendung mit Claude

https://github.com/user-attachments/assets/731621d7-0acf-4045-bacc-7b34a7d83648

Installationsoptionen

Vorgefertigtes von npm

Das Paket veröffentlicht eine mcp-nomad CLI. Die einfachste Option ohne Installation (wird in den npm-Cache heruntergeladen; erfordert Node/npm):

npx -y @kocierik/mcp-nomad

Oder installieren Sie es global, damit mcp-nomad in Ihrem PATH verfügbar ist:

npm install -g @kocierik/mcp-nomad

claude_desktop_config.json mit npx (empfohlen):

{
  "mcpServers": {
    "mcp_nomad": {
      "command": "npx",
      "args": ["-y", "@kocierik/mcp-nomad"],
      "env": {
        "NOMAD_TOKEN": "${NOMAD_TOKEN}",
        "NOMAD_ADDR": "${NOMAD_ADDR}"
      }
    }
  }
}

Wenn Sie npm install -g verwendet haben, behalten Sie command / args direkt als Binärdatei bei:

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

Von GitHub Releases

Laden Sie die Binärdatei herunter und konfigurieren Sie Claude Desktop wie folgt:

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

Aus Quellen bauen

go get github.com/kocierik/mcp-nomad
go install github.com/kocierik/mcp-nomad

Related MCP server: modbus-mcp

Server-Optionen

Befehlszeilen-Flags (auch relevant bei der Kopplung mit dem MCP Inspector gegen eine manuell gestartete Binärdatei):

  -nomad-addr string
    	Nomad server address (default "http://localhost:4646")
  -port string
    	Port for HTTP server (default "8080")
  -transport string
    	Transport type (stdio, sse, or streamable-http) (default "stdio")

Umgebungsvariablen

• NOMAD_ADDR: Nomad HTTP API-Adresse (Standard: http://localhost:4646)

• NOMAD_TOKEN: Nomad ACL-Token (optional)

• NOMAD_REGION: wird als REST region-Abfrageparameter weitergeleitet, wenn Aufrufer ihn nicht überschreiben (Multi-Region-Cluster)

• NOMAD_NAMESPACE: Standard-Namespace für Tools, die einen optionalen Namespace akzeptieren, wenn das Tool ihn weglässt

• TLS: NOMAD_CACERT, NOMAD_SKIP_VERIFY, NOMAD_TLS_SERVER_NAME (siehe utils/client.go / buildTLSConfig)

Der HTTP-Client folgt der offiziellen /v1/ API und ist über utils/client_*.go verteilt; MCP-Tools hängen von engen Schnittstellen in utils/nomad_tool_interfaces.go ab.

NomadClient.MakeRequest (nur für einige Cluster-/Legacy-Aufrufpunkte verwendet) lehnt Pfade außerhalb einer internen Zulassungsliste ab — bevorzugen Sie typisierte Helfer wie StopAllocation.

Mit MCP Inspector durchsuchen

Verwenden Sie dies für lokale Tests und Debugging — nicht erforderlich für den täglichen Gebrauch von Claude Desktop.

Um den neuesten veröffentlichten npm-Build unter dem MCP Inspector auszuführen:

npx @modelcontextprotocol/inspector npx @kocierik/mcp-nomad

Inspector mit einem lokalen HTTP-Server (optional)

Der Standardtransport ist stdio. Um den Inspector als Streamable HTTP anzuhängen, starten Sie die Binärdatei zuerst in einem anderen Terminal:

go run . -transport=streamable-http -port=8080

Öffnen Sie dann http://localhost:8080/mcp im Inspector. Für -transport=sse verwenden Sie http://localhost:8080/sse.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert - siehe die LICENSE-Datei für Details.