Learning Hour MCP

🚀 learning - hour - mcp

AIを使用してテクニカルコーチ向けの学習時間コンテンツを生成します。4C学習モデルを通じて開発チームが技術的卓越性を習得するのに役立つ構造化された練習セッションを作成します。

🚀 クイックスタート

インストール後、Claudeで以下を試してみてください。

"Use the learning hour tools to create a session about the Extract Method refactoring"

Claudeは以下の内容を含む60分間の完全なセッションプランを生成します。

• オープニングコネクションアクティビティ
• 概念の紹介
• 実践的なコーディング演習
• 振り返りとコミットメント

✨ 主な機能

これは、テクニカルコーチが学習時間（構造化された60分間の練習セッションで、チームが意識的な練習を通じてコーディングスキルを向上させる）を実施するのを支援するMCPサーバーです。セッションプラン、コード例を生成し、インタラクティブなMiroボードを作成することもできます。

📦 インストール

前提条件

1. Claude Desktop - デスクトップアプリをインストールします。
2. Anthropic API Key - サインアップしてキーを作成します（新規アカウントには5ドルの無料クレジットがあります）。

セットアップの完了

好みのエディターを選択してください。

Claude Desktop

Claude Desktopの設定に以下を追加します。

{
  "mcpServers": {
    "learning-hour": {
      "command": "npx",
      "args": ["-y", "learning-hour-mcp"],
      "env": {
        "ANTHROPIC_API_KEY": "your-anthropic-key",
        "MIRO_ACCESS_TOKEN": "your-miro-token-optional",
        "GITHUB_TOKEN": "your-github-token-optional"
      }
    }
  }
}

設定手順：

1. Claude Desktopの設定を開きます（cmd/ctrl + ,）。
2. "Developer" → "Edit Config"に移動します。
3. 上記の設定を貼り付けます。
4. your-anthropic-keyを実際のキーに置き換えます。
5. 設定を保存してClaude Desktopを再起動します。

VSCode

VSCodeのsettings.jsonに以下を追加します。

{
  "mcp.servers": {
    "learning-hour": {
      "command": "npx",
      "args": ["-y", "learning-hour-mcp"],
      "env": {
        "ANTHROPIC_API_KEY": "your-anthropic-key",
        "MIRO_ACCESS_TOKEN": "your-miro-token-optional",
        "GITHUB_TOKEN": "your-github-token-optional"
      }
    }
  }
}

設定手順：

1. MCP VSCode拡張機能をインストールします。
2. settings.jsonを開きます（Cmd/Ctrl+Shift+P → "Preferences: Open Settings (JSON)"）。
3. 上記の設定を追加します。
4. トークンを実際の値に置き換えます。
5. VSCodeウィンドウを再読み込みします（Cmd/Ctrl+Shift+P → "Developer: Reload Window"）。

Cursor

Cursorの設定に以下を追加します。

{
  "mcpServers": {
    "learning-hour": {
      "command": "npx",
      "args": ["-y", "learning-hour-mcp"],
      "env": {
        "ANTHROPIC_API_KEY": "your-anthropic-key",
        "MIRO_ACCESS_TOKEN": "your-miro-token-optional",
        "GITHUB_TOKEN": "your-github-token-optional"
      }
    }
  }
}

設定手順：

1. Cursorの設定を開きます（Cmd/Ctrl + ,）。
2. "Features" → "Claude" → "Advanced"をクリックします。
3. MCPサーバーの設定を追加します。
4. トークンを実際の値に置き換えます。
5. Cursorを再起動します。

必須事項：ANTHROPIC_API_KEYのみ必須です。他のトークンは追加機能を有効にします。

💻 使用例

基本的な使用法

インストール後、Claudeで以下のコマンドを試してください。

"Use the learning hour tools to create a session about the Extract Method refactoring"

高度な使用法

generate_session

4Cモデル（Connect, Concept, Concrete, Conclusion）に沿ったアクティビティを含む完全な学習時間セッションプランを生成します。

{
  "topic": "Feature Envy"
}

generate_code_example

特定のトピックに関する変更前後のコード例を作成します。

{
  "topic": "Extract Method",
  "language": "typescript"
}

create_miro_board

新しいMiroボードを作成するか、既存のボードにフレームを追加します（MIRO_ACCESS_TOKENが必要です）。

{
  "sessionContent": { /* from generate_session */ },
  "existingBoardId": "optional-board-id"  // If provided, adds frames to existing board
}

list_miro_boards

トークンでアクセス可能なすべてのMiroボードをリストします（MIRO_ACCESS_TOKENが必要です）。

{
  "limit": 50,  // Optional, max 50
  "cursor": "optional-pagination-cursor"
}

get_miro_board

特定のMiroボードの詳細を取得します（MIRO_ACCESS_TOKENが必要です）。

{
  "boardId": "board-id-to-get"
}

delete_miro_board

Miroボードを削除します（MIRO_ACCESS_TOKENが必要です）。注意して使用してください！

{
  "boardId": "board-id-to-delete",
  "confirm": true  // Required safety check
}

analyze_repository

GitHubリポジトリ内の実際のコード例を見つけます（GITHUB_TOKENが必要です）。

analyze_tech_stack

リポジトリの技術スタックを分析して、チーム固有のコンテンツを作成します（GITHUB_TOKENが必要です）。

オプション機能

Miroボード作成の有効化

学習時間を視覚的でインタラクティブなワークショップボードに変えましょう

Miroトークンを取得するには：

• Miro Appsにアクセスします。
• 新しいアプリを作成します（名前は"Learning Hours"）。
• アクセストークンをコピーします。
• 設定にMIRO_ACCESS_TOKENとして追加します。

リポジトリ分析の有効化

チームの実際のコードベースから実際のコード例を見つけましょう

GitHub Personal Access Tokenを作成します：

• 名前："Learning Hour MCP"
• 有効期限：90日（推奨）
• 権限：repo（読み取りアクセス）
• 設定にGITHUB_TOKENとして追加します。

詳細情報

• Diamante Technical Coaching - Refactor to Grow Newsletter
• SammanCoaching.org - テクニカルコーチングのリソースと学習時間ガイド
• Learning Hours - 学習時間トピックのカタログ
• 4C Learning Model - Connect, Concept, Concrete, Conclusion
• Technical Coaching - 役割と実践方法

トラブルシューティング

"Tool not found"エラー：設定を追加した後にClaude Desktopを再起動したことを確認してください。

"Invalid API key"：接頭辞（sk - ant - ...）を含めてキー全体を正しくコピーしたことを確認してください。

Miroボードが作成されない：MIRO_ACCESS_TOKENが有効で、ボード作成権限を持っていることを確認してください。

貢献方法

開発環境のセットアップとガイドラインについては、CONTRIBUTING.mdを参照してください。

📄 ライセンス

MIT