Hello World (UV Runtime)

Hello World UV ランタイムのサンプル

このサンプルでは、UV ランタイムを使用した最小限の MCP サーバーを紹介します。

UV ランタイムとは？

UV ランタイムを使用すると、Claude Desktop が拡張機能の Python と依存関係を自動的に管理できます。

• ユーザーのプラットフォームに適した Python のバージョンをダウンロードします
• 分離された仮想環境を作成します
• pyproject.toml から依存関係をインストールします
• ユーザーによる設定なしで、クロスプラットフォーム（Windows、macOS、Linux）で動作します

構成

hello-world-uv/
├── manifest.json       # server.type = "uv"
├── pyproject.toml      # Dependencies listed here
├── .mcpbignore        # Exclude build artifacts
└── src/
    └── server.py       # MCP server implementation

Python ランタイムとの主な違い

UV ランタイム（このサンプル）：

• server.type = "uv"
• 依存関係をバンドルしません
• mcp_config で uv run を使用し、pyproject.toml から依存関係を自動的に解決します
• バンドルサイズが小さい（約 2 KB）
• どのプラットフォームでも動作します

Python ランタイム（従来型）：

• server.type = "python"
• 依存関係を server/lib/ にバンドルする必要があります
• PYTHONPATH を設定した mcp_config が必要です
• バンドルサイズが大きくなります
• 純粋な Python のみで動作します（コンパイル済みの依存関係は使用できません）

インストール

mcpb pack

生成された .mcpb ファイルを Claude Desktop にインストールします。

ローカルでのテスト

# Install dependencies
uv sync

# Run server
uv run src/server.py

ツール

• say_hello - 名前を指定した人にあいさつします