运动图形美学MCP服务器
Three.js/WGBL程序化运动图形生成的分类基础
这是什么
一种模型上下文协议（MCP）服务器，提供 确定性美学参数 用于生成程序运动图形。该服务器基于Lushy的三层olog架构，将结构知识（分类学）与创造性综合分离，实现 60-85%的代币节省 与纯LLM方法相比。
它解决的问题
当前工作流程（纯Gemini 3）：
User describes motion → Gemini generates full code → Screen record问题：
- 每次迭代都会燃烧代币，重新生成结构知识
- 没有分类学基础=结果不一致
- 难以版本控制的美学参数
- 无法系统地构建美学领域
流畅的工作流程：
User describes intent → MCP maps to parameters (0 tokens) →
Gemini synthesizes structure with parameters (~200 tokens) →
Execute in browser → Screen record优点：
- 代币成本降低60-85%
- 分类学基础确保了可重复性
- 显式、版本可控的参数
- 分类结构支持域混合
建筑
语义桥：对象/外观/动作
自然映射到Three.js/WGBL结构：
- 物体 =几何限制+空间位置
- 看 =材料_系统+颜色_字体+灯光_食物
- 行动 =运动模式+时间节奏
三层Olog图案
第1层（基础-0个令牌）：
- 几何图元：球体、立方体、环面、圆柱体、平面、text_3d、二十面体、粒子系统
- 材料系统：金属、玻璃、霓虹灯、哑光、全息、塑料
- 运动模式：旋转、脉冲、浮动、螺旋、膨胀、波动、闪烁、轨道
- 调色板：赛博朋克、暖金色、冷蓝色、单色、火、森林
- 灯光氛围：戏剧性、柔和、霓虹、边缘、工作室
- 空间组合：居中、网格阵列、螺旋路径、随机散射、轨道环
第2层（确定性映射-0个标记）：
- 原始→ Three.js几何配置
- 材料→ 着色器/材质参数
- 运动→ 动画功能规范
- 调色板→ 精确的十六进制颜色值
- 照明→ WebGL灯光设置
- 所有映射都是确定性查找（零LLM成本）
第3层（合成接口-约200个令牌）：
- 为Gemini/Claude提供结构化参数
- LLM合成最终的HTML/CSS/JavaScript
- 仅用于代码生成，不用于参数发现
用法
1.浏览可用选项
# See what geometric primitives are available
list_geometric_primitives()
# Browse material systems
list_material_systems()
# Check motion patterns
list_motion_patterns()
# View color palettes
list_color_palettes()
# See lighting configurations
list_lighting_moods()2.地图参数（第2层-确定性）
# Map OBJECT/LOOK/ACTION to Three.js parameters
map_object_look_action(
primitive="sphere",
material="neon",
motion="pulse",
color_palette="cyberpunk",
lighting="neon_glow",
composition="centered"
)返回完整的Three.js参数规范（0个标记）。
3.生成合成上下文（第3层接口）
generate_synthesis_context(
primitive="torus",
material="metallic",
motion="rotate",
color_palette="warm_gold",
lighting="dramatic_side",
composition="centered",
user_intent="A luxurious rotating golden ring with warm lighting"
)退货：
- 第1-2层的所有确定性参数
- Gemini/Claude综合说明
- 意向性解释
- 成本分析
4.使用Gemini 3进行合成
将综合上下文传递给Gemini 3：
Prompt: [Paste complete synthesis context]Gemini使用Three.js动画生成自包含的HTML文件。
5.执行和捕获
- 保存HTML文件
- 在浏览器中打开
- 屏幕录制实时动画
- 在视频项目中使用
域函数（可组合性）
鸡尾酒美学→ 运动图形
apply_cocktail_aesthetic(
base_primitive="sphere",
base_motion="pulse",
cocktail_name="old_fashioned"
)将鸡尾酒灯光的氛围和颜色映射到Three.js参数：
- 古典鸡尾酒→ 温暖的钨丝灯，琥珀色调，戏剧性的侧面照明
- 得其利→ 凉爽的漫射光，清脆的蓝色
- 内格罗尼→ 戏剧性的红光，苦涩的强度
未来功能器
- 折纸→ 几何：折叠图案→ 结构组成
- Jazz → 节奏：时间结构→ 特技同步
- Wine → 材料：品尝笔记→ 表面质量
成本分析
纯LLM方法
User: "Create a glowing sphere that pulses"
→ Gemini generates full code: ~800 tokens
User: "Make it gold instead of purple"
→ Gemini regenerates: ~800 tokens
User: "Add rotation"
→ Gemini regenerates: ~800 tokens
Total: ~2400 tokens for 3 iterations郁郁葱葱的MCP方法
User: "Create a glowing sphere that pulses"
→ MCP maps parameters: 0 tokens
→ Gemini synthesis: ~200 tokens
User: "Make it gold instead of purple"
→ MCP updates palette: 0 tokens
→ Gemini synthesis: ~200 tokens
User: "Add rotation"
→ MCP adds motion: 0 tokens
→ Gemini synthesis: ~200 tokens
Total: ~600 tokens for 3 iterations (75% savings)示例组成
赛博朋克圈
generate_synthesis_context(
primitive="icosahedron",
material="neon",
motion="rotate",
color_palette="cyberpunk",
lighting="neon_glow"
)优雅的金戒指
generate_synthesis_context(
primitive="torus",
material="metallic",
motion="rotate",
color_palette="warm_gold",
lighting="dramatic_side"
)以太粒子云
generate_synthesis_context(
primitive="particle_system",
material="holographic",
motion="float",
color_palette="pastel_dream",
lighting="soft_ambient",
composition="random_scatter"
)安装
本地开发
cd motion-graphics-mcp
pip install -e .
python -m motion_graphics_mcpFastMCP云部署
# Push to GitHub
git init
git add .
git commit -m "Initial motion graphics MCP"
git push
# Deploy via FastMCP Cloud
# Entrypoint: server.py:mcp工具参考
第1层（基础）
list_geometric_primitives()-浏览OBJECT选项list_material_systems()-浏览LOOK选项list_motion_patterns()-浏览操作选项list_color_palettes()-查看配色方案list_lighting_moods()-查看照明配置list_spatial_compositions()-查看布局模式
第2层（确定性映射）
get_primitive_parameters(name)-获取Three.js几何配置get_material_parameters(name)-获取着色器/材质配置get_motion_parameters(name)-获取动画功能配置map_object_look_action(...)-完成对象/外观/动作映射
第3层（合成界面）
generate_synthesis_context(...)-编制规范的主要工具
域函数器
apply_cocktail_aesthetic(...)-用鸡尾酒美学作曲list_domain_functors()-查看可用的域名组合
元
get_intentionality()-了解这种方法为什么有效get_server_info()-服务器架构和使用
哲学
程序运动图形（代码驱动）优于手动关键帧：
- 数学平滑度：功能创建无法手动伪造的有机运动
- 无限迭代：更改参数，而不是关键帧
- 确定性的：相同的参数=相同的结果
- 组合性：通过函子进行系统域混合
- 高效：与纯LLM相比，代币节省60-85%
你描述视觉的能力比操纵时间线的能力更重要。
范畴结构
此MCP服务器是 郁郁葱葱的砖 -一个经过明确验证的美学模块，该模块：
- 定义完整的分类法（olog）
- 提供确定性映射（functor）
- 与其他域组合（自然转换）
- 保证结构连贯性（交换图）
OBJECT/LOK/ACTION模式是从美学意图到可执行代码的自然函数。
许可证
麻省理工学院
联系
由Lushy AI构建——人工智能创造者经济的分类基础设施。
- 网状物：https://lushy.ai
- 电子邮件：dal@lushy.ai