mcp-nomad

Использование с Claude

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

Варианты установки

Готовый пакет из npm

Пакет публикует CLI-инструмент mcp-nomad. Самый простой вариант без установки (загружается в кэш npm; требуется Node/npm):

npx -y @kocierik/mcp-nomad

Или установите глобально, чтобы mcp-nomad был доступен в вашем PATH:

npm install -g @kocierik/mcp-nomad

claude_desktop_config.json с использованием npx (рекомендуется):

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

Если вы использовали npm install -g, укажите command / args напрямую для бинарного файла:

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

Из релизов GitHub

Скачайте бинарный файл и настройте Claude Desktop следующим образом:

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

Сборка из исходного кода

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

Related MCP server: @profullstack/mcp-server

Параметры сервера

Флаги командной строки (также актуальны при использовании MCP Inspector с запущенным вручную бинарным файлом):

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

Переменные окружения

• NOMAD_ADDR: Адрес HTTP API Nomad (по умолчанию: http://localhost:4646)

• NOMAD_TOKEN: ACL-токен Nomad (необязательно)

• NOMAD_REGION: передается как параметр запроса REST region, если вызывающая сторона его не переопределяет (для мультирегиональных кластеров)

• NOMAD_NAMESPACE: пространство имен по умолчанию для инструментов, которые принимают необязательное пространство имен, если оно не указано в инструменте

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

HTTP-клиент следует официальному API /v1/ и разделен на части в utils/client_*.go; инструменты MCP зависят от узких интерфейсов в utils/nomad_tool_interfaces.go.

NomadClient.MakeRequest (используется только для нескольких вызовов кластера/устаревших методов) отклоняет пути вне внутреннего списка разрешенных — отдавайте предпочтение типизированным помощникам, таким как StopAllocation.

Просмотр с помощью MCP Inspector

Используйте это для локального тестирования и отладки — не требуется для повседневного использования Claude Desktop.

Чтобы запустить последнюю опубликованную сборку npm в MCP Inspector:

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

Inspector с локальным HTTP-сервером (необязательно)

Транспорт по умолчанию — stdio. Чтобы подключить Inspector как Streamable HTTP, сначала запустите бинарный файл в другом терминале:

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

Затем откройте http://localhost:8080/mcp в Inspector. Для -transport=sse используйте http://localhost:8080/sse.

Лицензия

Этот проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.