Learning Hour MCP

🚀 學習小時MCP

本項目藉助人工智能為技術教練生成學習小時內容。通過4C學習模型，創建結構化的練習環節，助力開發團隊掌握卓越的技術能力。

🚀 快速開始

安裝完成後，在Claude中嘗試輸入以下內容：

"使用學習小時工具創建一個關於提取方法重構的練習環節"

Claude將生成一份完整的60分鐘練習環節計劃，內容包括：

• 開場連接活動
• 概念介紹
• 實踐編碼練習
• 反思與承諾

✨ 主要特性

這是一個MCP服務器，可幫助技術教練開展學習小時活動。學習小時是一種結構化的60分鐘練習環節，團隊可通過有針對性的練習提升編碼技能。該服務器能生成練習環節計劃、代碼示例，甚至可以創建交互式的Miro看板。

📦 安裝指南

前提條件

1. Claude桌面版 - 安裝桌面應用程序
2. Anthropic API密鑰 - 註冊並創建一個密鑰（新賬戶有5美元的免費額度）

完整設置

選擇你偏好的編輯器：

Claude桌面版

將以下內容添加到Claude桌面版配置中：

{
  "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桌面版設置（cmd/ctrl + ,）
2. 轉到“開發者” → “編輯配置”
3. 粘貼上述配置
4. 將your-anthropic-key替換為你實際的密鑰
5. 保存並重啟Claude桌面版

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 → “首選項: 打開設置 (JSON)”）
3. 添加上述配置
4. 將令牌替換為你實際的值
5. 重新加載VSCode窗口（Cmd/Ctrl+Shift+P → “開發者: 重新加載窗口”）

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. 點擊“功能” → “Claude” → “高級”
3. 添加MCP服務器配置
4. 將令牌替換為你實際的值
5. 重啟Cursor

必需項：僅ANTHROPIC_API_KEY是必需的。其他令牌可啟用額外功能。

💻 使用示例

基礎用法

generate_session

生成一個完整的學習小時練習環節計劃，其中的活動遵循4C模型（連接、概念、實踐、總結）。

{
  "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應用
• 創建一個新應用（命名為“學習小時”）
• 複製訪問令牌
• 在你的配置中添加為MIRO_ACCESS_TOKEN

啟用倉庫分析

從團隊的實際代碼庫中查找真實的代碼示例

創建一個GitHub個人訪問令牌：

• 名稱：“學習小時MCP”
• 有效期：90天（建議）
• 權限：repo（只讀訪問）
• 在你的配置中添加為GITHUB_TOKEN

瞭解更多

• Diamante技術教練 - 成長式重構時事通訊
• SammanCoaching.org - 技術教練資源和學習小時指南
• 學習小時 - 學習小時主題目錄
• 4C學習模型 - 連接、概念、實踐、總結
• 技術教練 - 角色與實踐

故障排除

“未找到工具”錯誤：確保在添加配置後重啟了Claude桌面版。

“無效的API密鑰”：檢查你是否複製了完整的密鑰，包括任何前綴（sk-ant-...）。

Miro看板無法創建：檢查你的MIRO_ACCESS_TOKEN是否有效，並且具有創建看板的權限。

貢獻代碼

有關開發設置和指南，請參閱CONTRIBUTING.md。

📄 許可證

本項目採用MIT許可證。