Learning Hour MCP

🚀 learning-hour-mcp

learning-hour-mcp 藉助人工智能為技術教練生成學習時間（Learning Hour）內容。它能創建結構化的練習課程，助力開發團隊通過 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": { /* 來自 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 應用
• 創建一個新應用（命名為“Learning Hours”）
• 複製訪問令牌
• 在你的配置中添加為 MIRO_ACCESS_TOKEN

啟用倉庫分析

從團隊的實際代碼庫中查找真實的代碼示例 創建一個 GitHub 個人訪問令牌：

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

瞭解更多

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

故障排除

• “未找到工具”錯誤：確保在添加配置後重啟了 Claude 桌面應用。
• “無效的 API 密鑰”：檢查你是否複製了完整的密鑰，包括任何前綴（sk-ant-...）。
• Miro 看板無法創建：檢查你的 MIRO_ACCESS_TOKEN 是否有效，並且具有創建看板的權限。

貢獻代碼

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

📄 許可證

本項目採用 MIT 許可證。