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