Waldur MCP サーバー

Name: Waldur MCP Server
Author: waldur

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が表示されます。