星战科技xingzhan.cloud
返回市场
学习时长统计-mcp

学习时长统计-mcp

作者：SDiamante136 星标更新：2025-06-24
安装使用来源：spider==github.com

项目介绍

learning-hour-mcp

使用AI生成技术教练用于学习小时的技术内容。创建有结构的实践课程，帮助开发团队通过4C学习模型掌握技术卓越。

这是什么？

这是一个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": {
        你的配置信息
      }
    }
  }
}

配置步骤：

  1. 打开Cursor设置（Cmd/Ctrl + ,）
  2. 点击“功能”→“Claude”→“高级”
  3. 添加MCP服务器配置
  4. 将令牌替换为您实际的值
  5. 重启Cursor

必需项：仅需ANTHROPIC_API_KEY。其他令牌启用额外功能。

快速开始

安装后，在Claude中尝试以下操作：

"使用学习小时工具创建关于提取方法重构的课程"

Claude将生成完整的60分钟课程计划，包括：

  • 开始连接活动
  • 概念介绍
  • 实践编程练习
  • 反思与承诺

可用工具

generate_session

根据4C模型（连接、概念、具体、结论）生成完整的学习小时课程计划。

{
  "topic": "特性嫉妒"
}

generate_code_example

为特定主题创建前后代码示例。

{
  "topic": "提取方法",
  "language": "typescript"
}

create_miro_board

创建新的Miro白板或向现有白板添加框架（需要MIRO_ACCESS_TOKEN）。

{
  "sessionContent": { /* 从generate_session获取 */ },
  "existingBoardId": "可选的白板ID"  // 如果提供，则添加到现有白板
}

list_miro_boards

列出您可以访问的所有Miro白板（需要MIRO_ACCESS_TOKEN）。

{
  "limit": 50,  // 可选，最大50
  "cursor": "可选的分页游标"
}

get_miro_board

获取特定Miro白板的详细信息（需要MIRO_ACCESS_TOKEN）。

{
  "boardId": "要获取的白板ID"
}

delete_miro_board

删除Miro白板（需要MIRO_ACCESS_TOKEN）。谨慎使用！

{
  "boardId": "要删除的白板ID",
  "confirm": true  // 必要的安全检查
}

analyze_repository

在GitHub存储库中查找真实的代码示例（需要GITHUB_TOKEN）。

analyze_tech_stack

分析存储库的技术栈以创建针对团队的内容（需要GITHUB_TOKEN）。

可选功能

启用Miro白板创建

将您的学习小时转变为视觉互动工作坊白板

获取Miro令牌：

  • 前往Miro应用
  • 创建一个新的应用（命名为“学习小时”）
  • 复制访问令牌
  • 在您的配置中添加为MIRO_ACCESS_TOKEN

启用存储库分析

从您团队的实际代码库中查找真实代码示例

创建GitHub个人访问令牌：

  • 名称：“学习小时MCP”
  • 过期时间：90天（推荐）
  • 权限：repo（读取权限）
  • 在您的配置中添加为GITHUB_TOKEN

更多了解

故障排除

“未找到工具”错误：确保在添加配置后重新启动了Claude桌面。

“无效API密钥”：检查是否复制了整个密钥，包括任何前缀（sk-ant-...）。

Miro白板未创建：检查您的MIRO_ACCESS_TOKEN是否有效且具有创建白板的权限。

贡献

参见CONTRIBUTING.md以了解开发设置和指南。

许可证

MIT