交互式学习插件

ChironMCP是一个基于Blender的交互式学习插件,提供教程UI渲染、学习路径跟踪和本地验证功能,适用于Blender技能学习和教学场景。

  • by murdadrum
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 murdadrum/ChironMCP

使用说明

ChironMCP

ChironMCP 是启用MCP的网桥,允许Blender宿主 引导式互动学习体验 而不会损害Blender的开源精神。

哲学

Blender的生态系统建立在开放的基础上。ChironMCP尊重:

  • Blender插件是故意的 薄、可检查且与GPL兼容.
  • Chiron的价值不是“锁定Blender” 教学, 验证,以及 精心策划的学习设计.
  • 我们避免“租金抽取”订阅模式。用户应该感觉他们 拥有他们买的东西.

Blender的许可指南明确规定,使用Blender API的Python插件在分发时必须与GPL兼容,并且销售仅限于下载服务(客户享有相同的GPL自由)。我们欣然接受这一点。 (请参阅Blender许可证/常见问题解答。)

此回购包含什么

  • packages/chiron_blender_addon/ Blender插件(GPL友好):

    • 露出安全的工具表面进行辅导
    • 在Blender中渲染教程UI
    • 报告上下文+在本地验证步骤完成情况
    • 支持带有主题跟踪的学习路径
  • packages/chiron_mcp_server/ MCP服务器:

    • 将Chiron工具/资源/提示暴露给MCP兼容主机
    • 可以在本地运行以进行开发
    • 稍后可以代理为“Chiron Cloud Brain”

非目标

  • 在生产环境中,禁止“执行任意Python”。
  • 没有DRM影院。我们通过 课程包、更新和质量 --不是敌意。

快速入门(开发)

1) 运行MCP服务器

cd packages/chiron_mcp_server
uv sync --group dev
uv run python -m chiron_mcp_server.server

可选环境配置(用于聊天+LLM辅助教程):

  • CHIRON_LLM_ENDPOINT (法学硕士要求)
  • CHIRON_LLM_API_KEY (法学硕士要求)
  • CHIRON_LLM_MODEL (默认值: gpt-5.2)
  • CHIRON_SOURCE_TIMEOUT (默认值: 20)
  • CHIRON_SOURCE_USER_AGENT (可选)
  • CHIRON_SOURCE_COOKIE (可选)

2) 安装Blender插件(开发)

在Blender中:

  • 编辑->首选项->附加组件->安装。..
  • 选择 packages/chiron_blender_addon/chiron_mcp_addon.zip (下面的构建步骤)
  • 启用“ChironMCP”
    • 集 Server URL 如果您的MCP服务器未打开 http://localhost:8000

如果您更新了插件代码,但没有看到更改:

  • 使用以下命令重建zip scripts/build_addon_zip.sh
  • 在首选项中禁用或删除现有的“ChironMCP”插件
  • 重新启动搅拌机
  • 安装 dist/chiron_mcp_addon.zip 并再次启用它

3) 验证

  • 打开侧边栏面板(N-panel)->“Chiron”
  • 点击“Ping服务器”
  • 确认您看到祝酒词+成功回复
  • 在聊天面板中发送提示并确认您收到回复

注意:您还可以通过以下方式覆盖服务器URL CHIRON_MCP_URL 在Blender环境中。

学习路径(演示)

Chiron反映了Blender的手动结构,以驱动基于主题的课程。

  • 在附加组件首选项中启用“建模>几何节点”。
  • 在Chiron面板中,选择一个主题并单击“生成课程”
  • 已完成的主题被隐藏;使用“重置课程历史记录”重新测试。
  • 进展持续到 chiron/progress.json 和 chiron/lesson_history.json 在Blender的配置目录中。

当前几何节点主题来源于以下中的手动HTML树: https://github.com/murdadrum/Blender50Manual (blender_manual_v500_en.html/建模/几何节点)。

路线图

  • 教程运行时(本地):UI高亮显示+确定性步骤检查
  • 学习路径(几何节点)+主题跟踪
  • 签名课程包:版本化、可缓存、离线友好
  • Auth网关:OAuth设备流向未来的Chiron Cloud Brain
  • 多型号支持:Gemini today;明天可插拔型号适配器

许可证

  • Blender插件:GPL兼容(Blender对分布式插件的许可要求)
  • MCP服务器:根据需要兼容MIT(推荐)或GPL,具体取决于链接和分发策略