Faroz

Faroz MCP 服务 — 面向儿童教育平台的远程 MCP

端点： https://faroz.uz/mcp · 文档： faroz.uz/faroz-mcp · 注册表： uz.faroz/faroz · 身份验证： OAuth 2.0（无需 API 密钥）

将 AI 助手（Claude、ChatGPT、Gemini 和任何 MCP 客户端）连接到 Faroz。Faroz 是一个面向 8–17 岁儿童的学习平台。教师、家长和内容作者可以通过与助手对话，规划课程、创建学习内容、安排课程日历、检查学生的作业，并培养符合年龄特点的习惯。

传输方式：Streamable HTTP。身份验证：OAuth 2.0，支持动态客户端注册——客户端首次使用时会打开 Faroz 登录页面。

你可以做什么

领域	功能
课程	浏览课程目录和自己的课程、搜索、查看完整详情（课程、练习、科目、级别、年龄范围）。创建课程，并编辑标题、描述、科目、级别、年龄范围、标签和可见性。
课程内容	向课程中添加课程内容、编辑课程内容、为每节课程内容附加最多 5 个练习（自己的练习，或通过 ID、标题、描述或类别找到的其他教师的练习）、重新排列课程计划，并通过任务文本启用作业。
课程日历	查看课程的日程安排，将课程移至其他日期或时间，添加额外课程，或更改小组的每周时间表。新课程会自动安排到日历中。
作业批阅	列出学生的提交内容，打开其中一份以查看任务、学生的评论、照片，以及 PDF / Word / PowerPoint 文件中的文本；然后为作业评分（0–100）并提供学生可在应用中看到的反馈，或退回作业要求重做。成绩会影响学生的掌握程度。
学生进度	查看课程学生的掌握程度排名（不含电话号码或电子邮件地址）。
互动练习	将任何文本、主题或课程计划转换为可直接使用的练习。每个练习在保存前都会按 Faroz 格式进行检查，确保能在移动应用和 Web 应用中正确打开。
游戏	浏览游戏类别和游戏。拥有 games 权限的作者可以使用 1–20 个练习制作游戏。
资源库	浏览科目树和自己的媒体库（视频、音频、图片），以便在练习中重复使用；还可以为自己的媒体编写标题、描述和标签。
推荐与策略	创建带有年龄范围和日期的推荐，并将其归入策略（例如“战胜懒惰”），让适龄儿童可以按步骤执行。
搜索	一次搜索课程、练习、视频、音频、图片、推荐和策略。

练习内容块类型（11 种 + 2 种布局）

文本选择题 · 图片选择题 · 填空题 · 输入答案 · 口头回答（语音识别）· 图片 · 图片库 · 音频 · 视频 · 样式化富文本 · 提示框（规则、示例、技巧）

布局块：column（内容块上下排列——例如，在一个提示框中放置多个内容块）和 row（2–3 个内容块并排显示，宽度相等，手机上也一样）。

工具

只读： whoami、search、fetch、list_courses、get_course、get_course_filters、get_course_schedule、list_course_students、list_homework_submissions、get_homework_submission、list_exercises、get_exercise、get_exercise_usages、get_exercise_format_guide、validate_exercise_body、list_game_categories、list_games、list_media、list_subjects

创建： create_course、add_lesson、create_exercise、create_game、add_calendar_lesson、create_recommendation、create_strategy、add_strategy_recommendations

编辑（覆盖现有内容）： update_course、update_lesson、reorder_lessons、reschedule_lesson、set_group_schedule、update_exercise、update_game、update_media、review_homework、update_recommendation、update_strategy、reorder_strategy_stages

没有删除工具，也不处理付款：此服务不会显示或更改价格、订阅和钱包。每次调用均以已登录用户的身份执行，权限与 Faroz 应用中的权限完全相同。作业工具仅适用于课程工作人员（教师、助教、课程管理员）。

构建完整课程（内置操作指南）

每个客户端都会自动获得相同的课程创作操作指南——无需设置：

• 服务说明会指示助手在创建课程前阅读该指南。
• 工具指南： get_exercise_format_guide(topics=["course_authoring"]) 会返回完整的操作指南（也可通过资源 faroz://docs/exercise/course_authoring 获取）。
• 提示词： create_course（参数：topic、可选的 audience、lessons）——在 Claude 中从提示词菜单选择，在 Gemini CLI 中运行 /create_course。
• 工具结果： create_course 会返回 next_steps；create_exercise / update_exercise 会返回 validation_warnings（例如，测试没有问题、文本未设置样式），以便助手修复。
• 技能文件： skills/faroz-course-builder/SKILL.md — 将其作为技能上传到 Claude，或通过 ChatGPT/Codex 插件使用。

操作指南会强制要求：填写完整的课程元数据并添加横幅；设置 4–6 节课，每节包含 2–3 道练习（理论 → 实践 → 测试，最后安排最终测试）；课程中涵盖全部 11 种内容块类型（并在合适时使用 column / row 布局）；每个答案块上方都有对应问题；设置文本样式并添加提示框；验证图片、视频和音频链接；在 1–2 节课中布置作业；使用 is_active=false 构建课程，并仅在最终检查后发布。

作业

学生在 Faroz 应用中提交课程的课后作业：图片、音频、PDF、Word 文档或演示文稿，总计最多 20 MB，还可附上可选评论。文件会以私密方式存储，且只能通过会过期的签名链接提供。教师可在应用中或通过此服务使用 AI 助手进行批改。

安装

Claude： Settings → Connectors → Add custom connector → URL https://faroz.uz/mcp → Connect → 使用 Faroz 账号登录。

ChatGPT： Settings → Apps & Connectors → Advanced → Developer mode → Create → MCP Server URL https://faroz.uz/mcp，Authentication：OAuth。

Claude Code

claude mcp add --transport http faroz https://faroz.uz/mcp

Cursor、VS Code、Windsurf 和其他 mcp.json 客户端

{
  "mcpServers": {
    "faroz": { "url": "https://faroz.uz/mcp" }
  }
}

Gemini CLI

gemini extensions install https://github.com/Akramjon-koder/faroz-mcp

任何 MCP 客户端： 使用 URL https://faroz.uz/mcp 添加远程服务。客户端会注册自身（RFC 7591），然后打开 Faroz 登录页面（使用电子邮箱/密码或 Google 登录）。

示例提示词

• “创建一门适合 5 年级学生的分数数学课程，包含 4 节课，每节课有 2 道练习题。”
• “为 9–13 岁的孩子制作一门精彩的太阳系课程。”（助手会遵循课程指南：横幅、视频、图片、测试、作业）
• “这里有一段关于水循环的文字。请根据它创建一道选择题、一道填空题和一道文字作答题，然后将它们添加到第 2 课中。”
• “打开我的分数课程，检查每节课的练习题是否有错误或表述不清，并修正发现的问题。”
• “显示我的课程，并列出第一节课中的练习题。”
• “检查我的分数课程中所有等待批改的作业，为每份作业评分，并为每位学生撰写简短反馈。”
• “我的课程中掌握程度排名前 5 的学生是谁？”
• “把我的分数课程明天的课调到周五 16:00。”
• “根据合适的建议，为 10–12 岁的孩子制定一套‘战胜懒惰’策略，并为 11 月添加一条新的每日建议。”

要求

需要一个免费的 Faroz 账户：在 faroz.uz 注册。无需 API 密钥。

路线图

可能的后续步骤：

• 为教师和家长提供每位学生的进度报告
• 帮助学生学习课程内容并跟进学习进度

许可证

此代码库中的文件（扩展清单、上下文文件和技能）根据 MIT License 发布。Faroz 平台以及 https://faroz.uz/mcp 背后的 MCP 服务均为专有服务。

隐私与支持

• 隐私政策：https://faroz.uz/privacy
• 条款：https://faroz.uz/terms
• 支持：[email protected]