Waldur MCP server

Waldur MCP サーバー

Waldur MCP サーバーは、Model Context Protocol（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. Username > Credentials > API Token に移動します
3. 適切な有効期間を設定して新しいトークンを生成します。設定に必要です

Claude Desktop 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

デバッグ時には、必要な環境変数を設定する必要があります。起動すると、Inspector にブラウザーからアクセスできる URL が表示され、デバッグを開始できます。

よくある問題

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