CodeTour

アニメーションによる、LLM駆動の**「5歳児に説明するように」GitHub PR ツアー**。

CodeTour は、ローカルブラウザビューアと組み合わせた MCP サーバーです。 Claude（または MCP を駆動する任意の LLM）が CodeTour のツールを段階的に呼び出します。ビューアは プルリクエスト — ファイルツリー、差分、点滅する行ハイライト — をアニメーション表示し、 ナレーションはキャプションとして表示され、ブラウザの組み込みテキスト読み上げ機能によって読み上げられます。 各ストップは GitHub へのリンクになっているので、閲覧者は自分で詳細を掘り下げられます。

仕組み

Claude ──(MCP stdio)──▶ codetour ──(WebSocket)──▶ your browser
                          │
                          └──(REST)──▶ GitHub API

1. LLM が get_pr_info / get_file_diff を呼び出して CodeTour を通じて PR を読み取るので、その ナレーションは表示されている内容と正確に一致します。

2. start_tour はブラウザでビューアを開き、開始 をクリックするまで待機します （クリックでオーディオも有効になります）。

3. show_overview と一連の show_step 呼び出しが変更をアニメーション表示します。各 呼び出しはナレーションの読み上げが終わるまでブロックされるため、ツアーは自然に進行します。

4. end_tour は、GitHub 上の PR へのリンク付きのクロージングサマリーを表示します。

インストール

Python 3.11+ と uv が必要です。

git clone <this repo> && cd CodeTour
uv sync

Claude Code にユーザースコープで登録すると、すべてのリポジトリでツールが利用できるようになります：

claude mcp add --scope user codetour -- uv --directory /path/to/CodeTour run codetour

あとは、次のように尋ねるだけです：

https://github.com/owner/repo/pull/123 のエグゼクティブツアーを見せてください

codetour スキル

このリポジトリには、Claude Code スキル（skills/codetour/SKILL.md）が同梱されており、 Claude に良いツアーの作法を教えます：現在のブランチの PR を gh で自動検出し、ビューアを開く前に 3〜7 のストップを計画し、ELI5 ナレーションのスタイルルール、そしてビューアが閉じられたときの 復旧方法を学びます。リンク（またはコピー）して 個人のスキルディレクトリにインストールしてください：

ln -s /path/to/CodeTour/skills/codetour ~/.claude/skills/codetour

スキルをインストールすると、どのリポジトリでも「この PR のツアー」という簡単な指示で正しく動作します。 MCP サーバーまたはスキルをインストールした後は、Claude Code セッションを再起動してください。

GitHub 認証

公開 PR は認証なしで動作します（レート制限は低めです）。プライベートリポジトリや、より高い制限が必要な場合は、 CodeTour は次のうち最初に見つかったものを使います：GITHUB_TOKEN、GH_TOKEN、または gh CLI の保存済みトークン （gh auth login）。

設定

開発

uv run pytest                 # unit tests
uv run ruff check .           # lint
uv run codetour --demo        # web viewer only, replays a canned tour on a loop

デモモードはフロントエンドを反復する最も手っ取り早い方法です：MCP クライアントも GitHub アクセスも不要で、 表示された URL を開いて「開始」をクリックし、あらかじめ用意されたツアーを確認できます。

MCP ツール