mcp-nomad

Claude와 함께 사용

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

설치 옵션

사전 빌드된 NPM

이 패키지는 mcp-nomad CLI를 게시합니다. 가장 쉬운 무설치 옵션입니다(npm 캐시로 다운로드; Node/npm 필요):

npx -y @kocierik/mcp-nomad

또는 전역으로 설치하여 mcp-nomad가 PATH에 포함되도록 합니다:

npm install -g @kocierik/mcp-nomad

**npx**를 사용하는 claude_desktop_config.json (권장):

{
  "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: modbus-mcp

서버 옵션

명령줄 플래그 (수동으로 시작된 바이너리에 대해 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: Nomad HTTP API 주소 (기본값: http://localhost:4646)

• NOMAD_TOKEN: Nomad ACL 토큰 (선택 사항)

• NOMAD_REGION: 호출자가 재정의하지 않을 때 REST region 쿼리 매개변수로 전달됨 (다중 리전 클러스터)

• NOMAD_NAMESPACE: 도구가 네임스페이스를 생략할 때 선택적 네임스페이스를 허용하는 도구에 대한 기본 네임스페이스

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

HTTP 클라이언트는 공식 /v1/ API를 따르며 utils/client_*.go에 분산되어 있습니다. MCP 도구는 utils/nomad_tool_interfaces.go의 좁은 인터페이스에 의존합니다.

NomadClient.MakeRequest (일부 클러스터/레거시 호출 사이트에만 사용됨)는 내부 허용 목록 외부의 경로를 거부합니다. StopAllocation과 같은 유형화된 도우미를 사용하는 것이 좋습니다.

MCP Inspector로 탐색

로컬 테스트 및 디버깅용으로 사용하세요. Claude Desktop 일상 사용에는 필요하지 않습니다.

MCP Inspector에서 최신 게시된 npm 빌드를 실행하려면:

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

로컬 HTTP 서버를 사용하는 Inspector (선택 사항)

기본 전송은 stdio입니다. Inspector를 Streamable HTTP로 연결하려면 먼저 다른 터미널에서 바이너리를 시작하세요:

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

그런 다음 Inspector에서 **http://localhost:8080/mcp**를 엽니다. -transport=sse의 경우 **http://localhost:8080/sse**를 사용하세요.

라이선스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.