mcp-nomad

Usar con Claude

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

Opciones de instalación

Precompilado desde npm

El paquete publica una CLI mcp-nomad. La opción más sencilla sin instalación (se descarga en la caché de npm; requiere Node/npm):

npx -y @kocierik/mcp-nomad

O instálalo globalmente para que mcp-nomad esté en tu PATH:

npm install -g @kocierik/mcp-nomad

claude_desktop_config.json con npx (recomendado):

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

Si usaste npm install -g, mantén command / args directamente como el binario:

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

Desde lanzamientos de GitHub

Descarga el binario y configura Claude Desktop de la siguiente manera:

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

Construcción desde el código fuente

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

Related MCP server: @profullstack/mcp-server

Opciones del servidor

Flags de línea de comandos (también relevantes al emparejar con el Inspector MCP contra un binario iniciado manualmente):

  -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")

Variables de entorno

• NOMAD_ADDR: Dirección de la API HTTP de Nomad (predeterminado: http://localhost:4646)

• NOMAD_TOKEN: Token ACL de Nomad (opcional)

• NOMAD_REGION: reenviado como el parámetro de consulta REST region cuando los llamadores no lo sobrescriben (clústeres multirregión)

• NOMAD_NAMESPACE: espacio de nombres predeterminado para herramientas que aceptan un espacio de nombres opcional cuando la herramienta lo omite

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

El cliente HTTP sigue la API oficial /v1/ y está dividido en utils/client_*.go; las herramientas MCP dependen de interfaces estrechas en utils/nomad_tool_interfaces.go.

NomadClient.MakeRequest (usado solo para unos pocos sitios de llamadas de clúster/legado) rechaza rutas fuera de una lista de permitidos interna; prefiere ayudantes tipados como StopAllocation.

Navegar con el Inspector MCP

Úsalo para pruebas locales y depuración; no es necesario para el uso diario de Claude Desktop.

Para ejecutar la última compilación de npm publicada bajo el Inspector MCP:

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

Inspector con un servidor HTTP local (opcional)

El transporte predeterminado es stdio. Para adjuntar el Inspector como HTTP transmitible, inicia el binario en otro terminal primero:

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

Luego abre http://localhost:8080/mcp en el Inspector. Para -transport=sse, usa http://localhost:8080/sse.

Licencia

Este proyecto está bajo la Licencia MIT; consulta el archivo LICENSE para más detalles.