Waldur MCP サーバー

Waldur MCPサーバーは、モデルコンテキストプロトコル（MCP）を実装することで、WaldurインスタンスとClaude Desktopの統合を可能にします。これにより、ClaudeはWaldurインスタンスと直接やり取りできるようになります。

クイックスタート

Claude Desktop リリースページから、お使いのプラットフォーム用の Claude Desktop をインストールします。
Python 3.13 以降をインストールします。
uv パッケージマネージャーをインストールします。

インストール

パッケージをインストールするには:

pip install waldur-mcp-server

またはUVの場合:

uv pip install waldur-mcp-server

Waldurトークンを生成する

Waldurインスタンスにログインする
ユーザー名 > 認証情報 > APIトークンに移動します
適切なトークン有効期間を持つ新しいトークンを生成します。これは設定に必要になります。

Claude デスクトップ MCP サーバー構成

Windows の場合: %APPDATA%\Claude\claude_desktop_config.json

MacOSの場合: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "waldur-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\waldur_service",
        "run",
        "waldur-mcp-server"
      ],
      "env": {
        "WALDUR_API_URL": "https://your-waldur-instance",
        "WALDUR_TOKEN": "your-token"
      }
    }
  }
}

{
  "mcpServers": {
    "waldur-mcp-server": {
      "command": "uvx",
      "args": [
        "waldur-mcp-server"
      ],
      "env": {
        "WALDUR_API_URL": "https://your-waldur-instance",
        "WALDUR_TOKEN": "your-token"
      }
    }
  }
}

デバッグ

macOSでは、ログファイルは~/Library/Logs/Claude/mcp.logにあります。

spawn uvx ENOENTエラーが発生した場合は、PATH 環境変数にuvがインストールされている Python インストールディレクトリが含まれていることを確認してください。または、設定ファイルでuvxへのフルパスを指定することもできます（例: ~/Library/Frameworks/Python.framework/Versions/3.13/bin/uvx

MCPサーバーはstdio経由で実行されるため、デバッグが困難になる場合があります。最適なデバッグ環境を実現するには、 MCP Inspectorの使用を強くお勧めします。

次のコマンドを使用して、 npm経由で MCP Inspector を起動できます。

npx @modelcontextprotocol/inspector uv --directory C:\\waldur_service run waldur-mcp-server

デバッグを行うには、必要な環境変数を設定する必要があります。起動すると、インスペクターにブラウザでアクセスしてデバッグを開始できるURLが表示されます。

よくある問題

無効なトークン: トークンの権限と有効期限を確認してください
接続の問題: WALDUR_API_URL にアクセスできるかどうかを確認してください

Waldur MCP Server