🚀 学习小时MCP
本项目借助人工智能为技术教练生成学习小时内容。通过4C学习模型，创建结构化的练习环节，助力开发团队掌握卓越的技术能力。
🚀 快速开始
安装完成后，在Claude中尝试输入以下内容：
"使用学习小时工具创建一个关于提取方法重构的练习环节"
Claude将生成一份完整的60分钟练习环节计划，内容包括：
- 开场连接活动
- 概念介绍
- 实践编码练习
- 反思与承诺
✨ 主要特性
这是一个MCP服务器，可帮助技术教练开展学习小时活动。学习小时是一种结构化的60分钟练习环节，团队可通过有针对性的练习提升编码技能。该服务器能生成练习环节计划、代码示例，甚至可以创建交互式的Miro看板。
📦 安装指南
前提条件
- Claude桌面版 - 安装桌面应用程序
- 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"
}
}
}
}
配置步骤：
- 打开Claude桌面版设置（cmd/ctrl + ,）
- 转到“开发者” → “编辑配置”
- 粘贴上述配置
- 将
your-anthropic-key替换为你实际的密钥 - 保存并重启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"
}
}
}
}
配置步骤：
- 安装MCP VSCode扩展
- 打开settings.json（Cmd/Ctrl+Shift+P → “首选项: 打开设置 (JSON)”）
- 添加上述配置
- 将令牌替换为你实际的值
- 重新加载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"
}
}
}
}
配置步骤：
- 打开Cursor设置（Cmd/Ctrl + ,）
- 点击“功能” → “Claude” → “高级”
- 添加MCP服务器配置
- 将令牌替换为你实际的值
- 重启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许可证。