Waldur Waldur MCP Server

🚀 Waldur MCP サーバー クイックスタートガイド

Waldur MCP サーバーのクイックスタートガイドです。このガイドを通じて、必要なソフトウェアのインストールからサーバーの設定、開発までの手順を説明します。

🚀 クイックスタート

必要ソフトウェアのインストール

1. Claude Desktop のインストール
   使用しているプラットフォームに合わせて、Claude Desktop リリースページ から適切なバージョンをダウンロードしてインストールしてください。

2. Python のインストール
   Python 3.10 以上のバージョンをインストールしてください。

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

Claude Desktop MCP サーバーの設定

Windows システムでは、設定ファイルのパスは \AppData\Roaming\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/api",
      "WALDUR_TOKEN": "your-token"
    }
  }
}

リリース済みのサーバー設定

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

💻 使用例

開発

ビルドとリリース

分发包を準備するには、以下の手順を実行します。

1. 依存関係を同期し、ロックファイルを更新します。

   uv sync
   

2. 分发包をビルドします。

   uv build
   

   これにより、dist/ ディレクトリにソースコードとバイナリディストリビューションが作成されます。

3. PyPI にリリースします。

   uv publish
   

   注意: PyPI の認証情報を環境変数またはコマンドライン引数で設定する必要があります。

   • トークン: --token または UV_PUBLISH_TOKEN
   • またはユーザー名/パスワード: --username/UV_PUBLISH_USERNAME と --password/UV_PUBLISH_PASSWORD

デバッグ

MCP サーバーは標準入出力で動作するため、デバッグが難しい場合があります。最適なデバッグ体験を得るために、MCP Inspector の使用を強くおすすめします。

npm を使用して以下のコマンドを実行することで、MCP Inspector を起動できます。

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

デバッグ時には、必要な環境変数を設定する必要があります。起動後、Inspector は URL を表示し、その URL をブラウザで開くことでデバッグを開始できます。