Learning Hour Mcp

笔记 TypeScript

🚀 learning-hour-mcp

learning-hour-mcp 借助人工智能为技术教练生成学习时间（Learning Hour）内容。它能创建结构化的练习课程，助力开发团队通过 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": { /* 来自 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 许可证。

0 条评论
分类：笔记

Learning Hour Mcp