Learning Hour MCP

🚀 learning-hour-mcp

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

📖 これは何ですか？

技術コーチが学習時間を実施するのを支援するMCPサーバーです。学習時間とは、チームが意識的な練習を通じてコーディングスキルを向上させる、構造化された60分間の練習セッションです。セッションプランやコード例を生成し、インタラクティブな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 Extensionをインストールします
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"

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

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

💻 使用例

基本的な使用法

以下のコマンドを使用して、学習時間のセッションを生成できます。

{
  "topic": "Feature Envy"
}

高度な使用法

特定のトピックに関するコード例を生成することもできます。

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

🛠️ 利用可能なツール

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"  // 提供された場合、既存のボードにフレームを追加します
}

list_miro_boards

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

{
  "limit": 50,  // オプション、最大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  // 必須の安全確認
}

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