Huaguoshan MCP Server

花果山教育平台 MCP 服务，为教师端提供 AI 工具集成。

功能

提供 49 个 MCP Tools，覆盖班级管理、灵兽系统、评分成长、学情分析、奖品商店、魔法工具等场景。

班级管理（8）

| Tool | 说明 | |------|------| | list_classes | 查看班级列表 | | get_class_overview | 查看班级概览 | | get_class_students | 查看学生列表 | | create_class | 创建班级 | | add_student | 添加学生 | | remove_student | 移除学生 | | update_class | 编辑班级信息 | | get_student_info | 查看学生详细档案（学校、年级、目标分、性格类型等） |

灵兽系统（7）

| Tool | 说明 | |------|------| | get_beast_wall | 查看班级灵兽墙 | | get_public_beasts | 浏览山海经灵兽录 | | get_beast_detail | 查看灵兽进化链 | | get_final_form_beasts | 查看可认领灵兽 | | hatch_beast | 为学生认领灵兽 | | get_evolution_config | 查看进化阈值配置 | | update_evolution_config | 修改进化阈值 |

评分成长（9）

| Tool | 说明 | |------|------| | score_student | 给学生评分 | | get_score_items | 查看评分项 | | get_rankings | 查看排行榜 | | get_student_points | 查看学生积分详情 | | get_behavior_dimensions | 查看行为维度 | | create_score_item | 创建评分项 | | delete_score_item | 删除评分项 | | update_score_item | 编辑评分项 | | manual_adjust_points | 手动调整学生积分/金币 |

行为维度管理（3）

| Tool | 说明 | |------|------| | create_dimension | 创建行为维度 | | update_dimension | 编辑行为维度 | | delete_dimension | 删除行为维度 |

学情分析（4）

| Tool | 说明 | |------|------| | get_analysis_subjects | 查看学情报告学科 | | get_analysis_list | 查看学情报告列表 | | get_report_list | 查看学生报告列表 | | get_student_report | 查看学生报告详情 |

奖品商店（5）

| Tool | 说明 | |------|------| | get_reward_items | 查看商品列表 | | redeem_reward | 为学生兑换奖品 | | create_reward_item | 创建商品 | | update_reward_item | 编辑商品 | | delete_reward_item | 删除商品 |

通知（4）

| Tool | 说明 | |------|------| | get_notifications | 查看通知列表 | | mark_notification_read | 标记通知已读 | | mark_all_notifications_read | 一键全部已读 | | get_unread_count | 获取未读数量 |

分享（1）

| Tool | 说明 | |------|------| | create_share_token | 生成家长查看链接 |

魔法工具 - AI 教学助手（8）

| Tool | 说明 | |------|------| | generate_exercises | AI 生成练习题（支持指定知识点、题量、难度、题型） | | explain_concept | AI 概念解释器 | | generate_poetry_story | 古诗词故事化 | | generate_math_story | 数学趣味故事 | | generate_teacher_message | AI 班主任寄语 | | generate_speech_draft | AI 演讲稿生成 | | translate_text | AI 文本翻译 | | get_tool_result | 查询生成结果（用于异步/超时场景） |

魔法工具为异步生成，调用后自动轮询结果（最长等待 60 秒），超时会返回任务 ID 供后续查询。

安装

npm install -g huaguoshan-mcp

或直接使用 npx：

npx huaguoshan-mcp

环境变量

| 变量 | 说明 | 默认值 | |------|------|--------| | HGS_API_URL | 后端 API 地址 | https://hgs.keyouji.com | | HGS_API_TOKEN | 教师登录 Token（必填） | - |

运行

HGS_API_TOKEN=your_token npx huaguoshan-mcp

在 OpenClaw 中使用

openclaw mcp set huaguoshan '{"command":"npx","args":["huaguoshan-mcp"],"env":{"HGS_API_URL":"https://hgs.keyouji.com","HGS_API_TOKEN":"your_token"}}'

在 Claude Code 中使用

在 .claude/settings.json 中添加：

{
  "mcpServers": {
    "huaguoshan": {
      "command": "npx",
      "args": ["huaguoshan-mcp"],
      "env": {
        "HGS_API_URL": "https://hgs.keyouji.com",
        "HGS_API_TOKEN": "your_token"
      }
    }
  }
}