Waldur MCP サーバー

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

クイックスタート

1. Claude Desktop リリース ページから、お使いのプラットフォーム用の Claude Desktop をインストールします。

2. Python 3.13 以降をインストールします。

3. uv パッケージ マネージャーをインストールします。

インストール

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

pip install waldur-mcp-server

またはUVの場合:

uv pip install waldur-mcp-server

Waldurトークンを生成する

1. Waldurインスタンスにログインする

2. ユーザー名 > 認証情報 > APIトークンに移動します

3. 適切なトークン有効期間を持つ新しいトークンを生成します。これは設定に必要になります。

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 にアクセスできるかどうかを確認してください