陶瓷釉料化学MCP服务器
将陶瓷釉料化学转化为视觉图像生成参数。
陶器上釉是化学直接产生感官结果的领域。这个MCP服务器对这种关系进行了数学编码，使陶艺家和研究人员能够生成图像，捕捉到他们釉料配方的视觉意图。
核心见解
专业的陶瓷知识不仅仅是化学知识，它是对“特定的氧化物+熔剂+气氛组合如何产生独特的视觉特征”的复杂压缩。该服务器不是构建一个通用的颜色混合器，而是捕获釉料化学的分类结构并将其映射到图像生成维度。
它做什么
服务器实现了一个三层olog框架：
- 范畴结构 （YAML olog）：形式化釉料化学的类型和态射
- 意向性 （推理文档）：为什么这些化学映射会产生视觉效果
- 执行 （MCP工具）：将化学规格组合成视觉参数的工具
视觉参数
服务器输出图像生成器理解的七个视觉维度：
- 光强 （0-10）：釉料看起来有多暗与多亮
- 还原气氛→ 深色（8-9） - 氧化气氛→ 明亮（3-5）
- 饱和度 （0-10）：颜色强度和纯度
- 按比例：着色剂类型、着色剂量、气氛、温度熟化
- 反射率 （0-10）：表面光泽与哑光
- 硼通量→ 光泽（9-10） - 碱土焊剂→ 哑光（2-3）
- 色调温度 （0=冷，5=中性，10=暖）
- 钴、铬→ 凉爽（1-3） - 铁、钒→ 温暖（7-9）
- 成熟度 （0-10）：釉料“完成”的感觉如何
- 锥体2（低火）→ 未成熟（3-4） - 锥体10（高火）→ 成熟（9-10岁）
- 晶体定义 （0-10）：表面纹理和水晶清晰度
- 随着烧制温度的升高而增加 - 光泽助焊剂抑制结晶度 - 哑光助焊剂使其成为可能
- 面流 （0-10）：运行/池行为
- 流体助焊剂+流动釉→ 高（7-9） - 硬质助焊剂+静态釉料→ 低（1-3）
支持的着色剂
| 着色剂 | 色调 | 温暖 | 纯度 | 注释 |
|---|---|---|---|---|
| 铁 | 棕色/红色/黑色 | 非常温暖（8/10） | 泥土色（6/10） | 最具多样性，具有历史意义 |
| 钴 | 蓝色/紫色 | 非常凉爽（1.5/10） | 纯净（9/10） | 强烈，少量有效 |
| 铜 | 绿色/红色 | 空档（5/10） | 响应式（8/10） | 大幅换档减少↔ 氧化作用 |
| 铬 | 绿色 | 凉爽（2/10） | 稳定（7/10） | 矿物状，大气稳定 |
| 锰 | 紫色/棕色 | 非常凉爽（1/10） | 静音（5/10） | 柔软，有机，适合混合 |
| 钒 | 黄色/绿色 | 暖色调（7/10） | 微妙（6.5/10） | 稀有，产生独特的暖色调 |
支持的通量系统
| 通量 | 反射率 | 角色 | 跑步 | 笔记 |
|---|---|---|---|---|
| 硼 | 9.5/10 | 光滑、镜面状 | 中等 | 创建最亮、最有光泽的表面 |
| 碱性的 | 6/10 | 缎面，流畅 | 高 | 创建有意的跑步和游泳 |
| 碱土 | 2.5/10 | 哑光，接地 | 低 | 最自然，泥土饰面 |
| 铅 | 8/10 | 玻璃般光滑 | 中等 | 历史悠久；现代使用需要测试 |
工具
analyze_glaze_formulation
分析特定的釉料化学成分并提取视觉参数。
result = analyze_glaze_formulation(
colorant="cobalt", # iron, cobalt, copper, chrome, manganese, vanadium
colorant_percentage=2.0, # amount in formulation (typically 0.5-15%)
flux_type="boron", # boron, alkaline, alkaline_earth, lead
atmosphere="reduction", # oxidation, reduction, neutral
cone=10, # firing cone (06 to 13)
runs=False # whether glaze is formulated to run
)退货： 词典与 visual_parameters, descriptive_qualities，以及 sensory_intention.
enhance_image_prompt_from_glaze
选取一个基础图像提示，并为其注入釉料美学品质。
enhanced = enhance_image_prompt_from_glaze(
base_prompt="a ceramic vase on a shelf",
colorant="copper",
flux_type="alkaline",
atmosphere="reduction",
cone=10
)退货： 自然编织的釉料特性增强了提示。
list_available_colorants
获取有关所有支持的着色剂的全面信息。
list_available_fluxes
获取有关所有支持的通量系统的全面信息。
compare_glaze_formulations （定性）
从概念上比较两种釉料描述的视觉差异。
使用示例
示例1：深蓝色还原釉
result = analyze_glaze_formulation(
colorant="cobalt",
colorant_percentage=2.0,
flux_type="boron",
atmosphere="reduction",
cone=10
)
# Returns:
# optical_intensity: 8.5 (dark, concentrated)
# saturation: 8.5 (deep blue)
# reflectivity: 9.5 (glossy, mirror-like)
# hue_temperature: 1.5 (cool)
# maturation_level: 9.5 (fully mature)
# sensory: "mysterious, concentrated, sultry; luminous and flowing"示例2：泥土哑光铁釉
result = analyze_glaze_formulation(
colorant="iron",
colorant_percentage=8.0,
flux_type="alkaline_earth",
atmosphere="oxidation",
cone=6
)
# Returns:
# optical_intensity: 4.0 (bright, transparent)
# saturation: 4.5 (muted earthy brown)
# reflectivity: 2.5 (matte)
# hue_temperature: 8.0 (very warm)
# maturation_level: 7.0 (well-matured)
# sensory: "clear, bright, direct; stable and grounded"示例3：运行铜还原
result = analyze_glaze_formulation(
colorant="copper",
colorant_percentage=8.0,
flux_type="alkaline",
atmosphere="reduction",
cone=10,
runs=True
)
# Returns:
# optical_intensity: 8.5 (dark, concentrated)
# saturation: 7.5 (deep red with mystery)
# reflectivity: 6.0 (satin fluid)
# surface_flow: 4.8 (runs due to fluid alkaline + runs=True)
# sensory: "mysterious, concentrated, sultry; fluid and dynamic"数学基础
服务器实现了这些分类态射：
Atmosphere → Color Modulation
reduction + any colorant → darker, more saturated, shifted hue
Flux → Surface Texture
boron → gloss (9.5)
alkaline → satin (6.0)
alkaline_earth → matte (2.5)
Temperature → Maturation
cone ≤ 2 → immature (3-4)
cone 5-6 → balanced (7)
cone ≥ 10 → mature (9-10)
Colorant → Visual Effect
cobalt → cool (1.5), pure (9), intense (8.5)
iron → warm (8), earthy (6), variable (6.5)
copper → responsive (5), versatile (8), variable (8)
...这些组成了一个统一的转换：
ColorDevelopment × FluxBehavior × Atmosphere × Temperature → VisualParameters其中视觉参数为：光学强度、饱和度、反射率、色调温度、成熟度、晶体定义、表面流。
与图像生成器集成
服务器输出的参数可直接用于Flux、Midjourney、Stable Diffusion等。
方法1：直接增强
使用 enhance_image_prompt_from_glaze() 要获得完整的增强提示：
Original: "a ceramic vase on a shelf"
Enhanced: "a ceramic vase on a shelf [glaze aesthetic: dark, concentrated optical quality; glossy mirror-like surface with strong light reflection; intensely saturated, vivid coloration; cool-toned, pure character; fully matured, intentional finish; feels mysterious, concentrated, sultry; luminous and flowing]"方法2：手动参数混合
提取视觉参数并将其混合到您自己的提示中：
result = analyze_glaze_formulation(...)
params = result["visual_parameters"]
# Then craft prompt incorporating:
# - Saturation level
# - Gloss/matte character
# - Color warmth
# - Maturation feeling
# - Surface flow description领域知识
此服务器精确编码陶器专业知识，因为陶器釉料包含 固有视觉信息陶工的配方选择直接指定了感官结果：
- “我在用硼熔剂” =“我想要具有光反射的光滑表面”
- “我在裁员” =“我想要黑暗、神秘、集中的颜色”
- “我添加了10%的钴” =“我想要强烈的、宝石般的蓝色”
MCP服务器使这种隐含的专业知识变得明确和可重复。
测试
运行测试套件：
cd pottery_glazing_mcp
pip install -e . --break-system-packages
pip install pytest --break-system-packages
python -m pytest tests/test_glaze_processor.py -v所有20项测试均验证：
- 个体态射正确性
- 复合釉分析一致性
- 参数范围（全部为0-10或适当限制）
- JSON可序列化性
- 感官意图映射准确性
建筑
pottery_glazing_mcp/
├── glazing_olog.yaml # Categorical structure (types, morphisms)
├── glaze_processor.py # Morphism implementations
├── server.py # MCP tool definitions
└── tests/
└── test_glaze_processor.py # 20 tests covering all dimensions后续步骤
- 部署到FastMCP.cloud进行远程访问
- 与Claude Desktop集成，实现多服务器组合
- 添加额外的着色剂（金红石、钛铁矿等）
- 添加结晶釉化学（亚光灰釉等）
- 发表关于感觉域分类编码的学术论文
参考文献
- Olog框架: 具有依赖类型的函数式数据结构
- 应用范畴理论：自然变换，伴随函数
- 陶艺学：Savage&Poston“陶瓷釉料”（基础参考）
- Lushy项目：将领域专业知识编码为视觉参数
______________________________________________________________________
作为Lushy项目的一部分创建：“通过严格的数学框架将领域专业知识转化为视觉表示的认识论基础设施。”