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ファイルを参照してください。