← Back to Skills Marketplace
282
Downloads
0
Stars
0
Active Installs
8
Versions
Install in OpenClaw
/install yuketang-mcp
Description
提供雨课堂账户和班级相关查询服务，包括用户ID、开班列表、班级数据、预警名单、今日授课及作业公告完成情况查询等。
Usage Guidance
要不要安装这项技能，先考虑下面几点：
- 信任来源：确认 https://www.yuketang.cn/ai-workspace/open-claw-skill 与 mcp_url（https://open-ai.xuetangx.com/...）确实属于你信任的雨课堂/学堂方；如果来源不清楚，别提供 Secret。
- Secret 使用与存储：安装脚本会把你填的 YUKETANG_SECRET 用作 Authorization header 并通过 mcporter 写入项目配置（可能保存在磁盘）。安装脚本还会在完成时静默通过 mcporter 向 MCP 服务上报安装事件（发送安装耗时与 action 字段）。如果你不希望这样，请手动编辑/审查脚本，或手动将配置写入，并避免运行自动上报逻辑。
- 不在对话中粘贴 Secret：文档建议“助手帮助用户更新环境变量”——在与助手交互时不要将 Secret 直接粘到聊天窗口（除非你信任本地客户端的保密策略）；更安全的做法是在本地终端设置环境变量或编辑配置文件。
- 核对注册元数据：平台上登记的元数据没有列出 YUKETANG_SECRET（显然是遗漏），如果你依赖元数据来决定权限，请先让发布方修正或在安装前确认。
- 撤销与清理：如果决定安装，记下 mcporter 配置文件位置（脚本已列出常见位置），并在卸载时手动移除相关条目和可能保存的凭据。
如果你能提供发布者主页或代码托管来源（如 GitHub/GitLab 仓库链接）并确认包来源无误，我可以把评级提升为“可信（benign）”。
Capability Analysis
Type: OpenClaw Skill
Name: yuketang-mcp
Version: 1.0.326682
The skill bundle provides integration with the YuKeTang educational platform via the Model Context Protocol (MCP). It includes setup scripts (setup.sh, setup.js) that automate the configuration of the mcporter client and instructions for the AI agent to query class statistics, student warnings, and schedule lessons. While the setup script includes a silent telemetry report (claw_report) and the instructions ask the agent to assist in setting environment variables, these behaviors are transparently documented and strictly aligned with the stated purpose of tool installation and service analytics, with all external communication directed to the official XuetangX domain (open-ai.xuetangx.com).
Capability Assessment
Purpose & Capability
技能说明与代码都表明这是一个通过 MCP（mcp-server）访问雨课堂服务的适配器，功能与描述一致；但注册元数据显示“Required env vars: none”，而 package.json 与安装脚本明确需要环境变量 YUKETANG_SECRET —— 这是不一致的，说明元数据未正确声明所需凭据。
Instruction Scope
SKILL.md 明确要求用户获取并设置 YUKETANG_SECRET，然后运行本地安装脚本以注册 MCP 服务；脚本会把 Secret 用作 Authorization header 注册到 mcporter 配置并进行验证。文档还建议助手在用户提供 secret 后帮助更新环境变量（这可能会诱导用户在会话中直接提交敏感凭据）。总体上指令在功能范围内，但涉及获取/处理敏感凭据，且文档没有充分说明如何安全传递/存储该 Secret。
Install Mechanism
无二进制安装规范（instruction-only + 脚本）。安装脚本通过 npx mcporter 操作（常见），没有从不信任的 URL 下载可执行文件。但是 setup.sh 在安装完成阶段会静默调用 npx mcporter call yuketang-mcp claw_report --args ... 将安装耗时与 action=install 上报到配置的 MCP 服务（静默、默认行为）。该上报是可疑点：虽只发送简单 telemetry，但会向远端通知安装发生，且使用的 mcporter 客户端将携带用户的 Authorization header（Secret）。
Credentials
只需要一个凭据 YUKETANG_SECRET，这与功能本身（访问雨课堂 MCP）是合理且比例合适；但 registry 元数据未列出该必需 env（显示 none），这是不一致并会误导用户。安装脚本会把 Secret 作为 Bearer token 传给 mcp server 并写入 mcporter 配置（可能存到磁盘），以及通过 mcporter 发起调用，从而使 Secret 被客户端/配置持久化——用户应确认其接受此存储和传输方式。
Persistence & Privilege
技能没有设置 always:true，也不修改其它技能或系统范围设置；脚本仅尝试以 project scope 为单位通过 mcporter 写入 MCP 服务配置（这是该类技能的常见做法）。唯一的额外持久化是 mcporter 客户端配置会存储服务 URL 与 headers（含 Authorization），这是功能性且在预期范围内，但用户应知晓该配置的位置并可手动移除。
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install yuketang-mcp - After installation, invoke the skill by name or use
/yuketang-mcp - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.326682
- 文档增加了"调用方式"示例，说明如何用 npx mcporter 命令调用技能工具。
- 主要内容未变，其他部分为格式与排版微调。
- 该版本进一步方便用户理解如何在命令行直接调用 yuketang-mcp 各项功能。
v1.0.326681
- 强化了 MCP 服务的调用规范：明确要求调用带参数的 MCP 工具时必须使用完整结构化 JSON，并严禁 mcporter 调用遗漏 --args 参数。
- 明确全局规则，补充了 MCP 相关的错误场景与参数传递说明。
- 其他内容无实质变更，仅文档细节微调。
v1.0.326674
- 强化安全配置：安装 Skill 时必须先卸载旧版，并强制提示不准用 copaw，仅允许用 npx mcporter 调用服务。
- 新增安装验证：安装完成后需立刻执行 claw_current_user 校验 Secret，有效无效分流提示，指导用户自动更新环境变量。
- 新增/细化工具说明，补充 cube_teacher_today_teaching_detail 用于单课程详情，并完善调用流程和默认策略描述。
- 补充典型问法、返回格式及参数表，提升易用性与调用规范。
- 严格输出要求，明文强调禁止自由表格渲染和信息篡改，规范环境变量获取与回写。
- 调整并优化说明文档结构，增加 Skill 功能描述与注意事项说明。
v1.0.4
yuketang-mcp v1.0.4
- 新增 setup.js 支持 Node.js 环境一键初始化配置
- SKILL.md 文档更新：补充/改进 Secret 获取、配置步骤与 cross-platform 安装说明
- 文档重组与扩写，完善工具使用场景速查表和各工具详细说明
- 新增 `ykt_teacher_correct_statistic`, `ykt_recent_exercise_submit`, `ykt_recent_notice_read` 工具说明
- 明确组合调用、参数格式及交互规则，优化用户配置与排障指引
v1.0.3
- No functional or documentation changes detected in version 1.0.3; content and capabilities remain unchanged.
- All files remain the same as the previous version, with no edits or updates.
v1.0.2
yuketang-mcp 1.0.2 Change Summary
- 移除用户意图场景表中的“查询我听的课/我选的课”与 ykt_learning_list 相关描述
- 保留了其他工具调用场景和交互规则
- 细化 ykt_classroom_statistics 的班级数据概览查询方式
- 工具使用和输出格式等核心规则未变
- 配置、权限与调用方式等说明保持一致
v1.0.1
yuketang-mcp v1.0.1
- 新增 cube_teacher_today_teaching 查询当天授课情况的工具。
- 新增 cube_lesson_reservation（预约开课）及 ykt_classroom_id_by_name（通过班级名查ID）工具及使用说明。
- 明确所有时间相关参数以当前系统绝对时间（北京时间）为准，禁止硬编码2025年或更早年份。
- 增加预约开课需二次确认、参数校验等使用规则。
- 工具调用流程与输出要求进一步细化，强调结构化结果及 emoji 保留。
v1.0.0
yuketang-mcp v1.0.0
- 首次发布，提供雨课堂 MCP 服务及各类查询工具。
- 新增详细文档，涵盖工具用法、参数、返回值说明。
- 支持通过 Secret 配置和 setup.sh 一键注册。
- 明确了用户意图识别、误触发规避及组合调用示例。
- 工具功能包括：授课/听课班级查询、账号信息、班级数据及预警学生名单查询。
- 结果格式结构化并保留 emoji，遵守权限和数据真实性限制。
Metadata
Frequently Asked Questions
What is yuketang-mcp?
提供雨课堂账户和班级相关查询服务，包括用户ID、开班列表、班级数据、预警名单、今日授课及作业公告完成情况查询等。 It is an AI Agent Skill for Claude Code / OpenClaw, with 282 downloads so far.
How do I install yuketang-mcp?
Run "/install yuketang-mcp" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is yuketang-mcp free?
Yes, yuketang-mcp is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does yuketang-mcp support?
yuketang-mcp is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created yuketang-mcp?
It is built and maintained by xuetangop (@xuetangop); the current version is v1.0.326682.
More Skills