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 许可证。