Hsp Aesthetic MCP

HSP美学

一个MCP服务器，将HSV（色调、饱和度、值）颜色参数映射到丰富的美学词汇表中，实现确定性颜色理论正确的调色板生成和图像生成提示的语义颜色增强。

概述

HSP美学通过以下方式连接数学和感官体验：

1. 提取颜色意图 来自自然语言提示
2. 生成色彩理论正确的调色板 利用调和关系
3. 将HSV值映射到美学词汇 （情绪、温度、材料、时代、能量）
4. 实现确定性色彩合成 没有LLM令牌

其结果是一个系统的框架，在这个框架中，颜色选择在数学上是连贯的，在语义上是富有表现力的，并且是可重复的。

核心工具

extract_color_intent

解析自然语言中与颜色相关的关键字，并映射到HSV值。

extract_color_intent(text: str) → Dict

退货：

• primary_hsv：{h，s，v}代表主色
• semantic_tags：匹配的颜色关键字
• mood：总体情绪描述符
• detected_conflicts：相互矛盾的关键词（例如，“冷静精力充沛”）
• temperature：“温暖”或“凉爽”

例子：

extract_color_intent("A calm, warm, earthy composition with hints of rust")
# Returns:
# primary_hsv: {h: 25, s: 65, v: 60}
# semantic_tags: ["calm", "warm", "earthy", "rust"]
# mood: "contemplative, grounded"
# temperature: "warm"

______________________________________________________________________

generate_harmony_palette

使用调和关系从基础HSV创建颜色理论校正调色板。

generate_harmony_palette(
    base_hue: float,              # 0-360°
    base_saturation: float,       # 0-100%
    base_value: float,            # 0-100%
    harmony_type: str = "complementary",
    palette_size: int = 5
) → Dict

和谐类型：

• complementary：底色+相反色调（180°）
• analogous：基础+相邻色调（±30°）
• triadic：基础色+两种相距120°的色调
• split_complementary：底色+两侧两种色调互补
• tetradic_rectangle：矩形排列的四种色调
• tetradic_square：四种色调，间隔90°
• monochromatic：单一色调，不同饱和度/值

退货：

• colors：｛h、s、v、十六进制、角色｝字典列表
• harmony_type：应用和谐
• contrast_ratios：关键颜色之间的对比度
• accessibility：WCAG合规级别（AAA、AA或失败）

例子：

generate_harmony_palette(
    base_hue=210,
    base_saturation=70,
    base_value=50,
    harmony_type="triadic",
    palette_size=5
)
# Returns 5-color palette with mathematical harmony

______________________________________________________________________

hsv_to_aesthetic_descriptors

将HSV值映射到多个维度的丰富美学词汇表中。

hsv_to_aesthetic_descriptors(
    hue: float,        # 0-360°
    saturation: float, # 0-100%
    value: float       # 0-100%
) → Dict

退货：

• color_name：人类可读名称
• temperature：“温暖”或“凉爽”
• mood_descriptors：情绪关键词列表
• energy_level：“低”、“中等”、“高”、“极端”
• era_associations：时间段关联
• material_suggestions：材料类型（金属、织物、陶瓷等）
• lighting_quality：照明特性（粗糙、柔和、金色等）
• texture_suggestions：纹理类型（光滑、粗糙、风化等）

例子：

hsv_to_aesthetic_descriptors(hue=25, saturation=65, value=60)
# Returns:
# color_name: "Burnt Sienna"
# temperature: "warm"
# mood_descriptors: ["nostalgic", "earthy", "contemplative"]
# energy_level: "moderate"
# era_associations: ["1970s", "art deco", "mid-century"]
# material_suggestions: ["ceramic", "leather", "clay", "weathered wood"]
# lighting_quality: "golden hour, soft ambient"
# texture_suggestions: ["matte", "weathered", "tactile"]

______________________________________________________________________

list_available_harmonies

列出所有和谐类型及其描述和用例。

list_available_harmonies() → Dict

退货： 具有特征的和谐类型以及何时使用每种类型

______________________________________________________________________

suggest_palette_from_mood

从情绪描述中建议最佳HSV基值和和声类型。

suggest_palette_from_mood(
    mood: str,              # e.g., "calm", "energetic", "mysterious"
    intensity: str = "moderate"  # "subtle", "moderate", "strong"
) → Dict

退货：

• suggested_base_hue：最佳色调
• suggested_base_saturation：最佳饱和度
• suggested_base_value：最佳值/亮度
• suggested_harmony_type：推荐和谐
• reasoning：建议说明

例子：

suggest_palette_from_mood(mood="mysterious", intensity="strong")
# Returns suggestions for deep, saturated purples/blacks
# with split-complementary harmony for tension

______________________________________________________________________

色调到情绪映射

服务器维护色调范围和美学维度之间的确定性关联：

饱和度到字符映射

值到亮度映射

工作流模式

模式1：情绪→ 调色板

User intent: "Create a calm, sophisticated palette"
↓
suggest_palette_from_mood(mood="calm", intensity="moderate")
↓
generate_harmony_palette(base_hue=..., harmony_type=...)
↓
Extract hex values for use in image generation

模式2：提示→ 增强色彩

User prompt: "A melancholic autumn scene with golden light"
↓
extract_color_intent(text=prompt)
↓
hsv_to_aesthetic_descriptors(hue=..., saturation=..., value=...)
↓
Synthesize color vocabulary into enhanced prompt

模式3：颜色分析→ 美学描述

Reference image with dominant colors
↓
Extract dominant HSV values
↓
hsv_to_aesthetic_descriptors()
↓
Map to mood/era/material descriptors
↓
Use as aesthetic anchors for new compositions

关键概念

色温

• 温暖 （红色、橙色、黄色）：0-60°和300-360°——与能量、激情、温暖有关
• 太酷了！ （绿色、青色、蓝色、紫色）：60-300°——与平静、沉思、距离有关

对比度

服务器计算调色板颜色之间的WCAG对比度：

• AAA：高对比度，包括色盲观众在内的所有人都可以观看
• AA：大多数用途可接受的对比度
• 失败：对比度不足，难以辨认

色彩和谐

在美学上连贯的色调之间的数学关系：

• 互补的：最大视觉张力，高对比度
• 类似的：和谐、相邻、自然流动
• 三元：平衡、充满活力、复杂
• 单色：统一、精致、冥想

实际案例

示例1：生成复杂的调色板

# Extract intent from natural language
intent = extract_color_intent(
    "A sophisticated, vintage palette with warm undertones and subtle grays"
)
# primary_hsv: {h: 30, s: 50, v: 55}

# Generate harmonious palette
palette = generate_harmony_palette(
    base_hue=intent["primary_hsv"]["h"],
    base_saturation=intent["primary_hsv"]["s"],
    base_value=intent["primary_hsv"]["v"],
    harmony_type="analogous",
    palette_size=6
)
# Returns 6 colors: warm tan, muted gold, sage, gray-taupe, cream, charcoal

示例2：基于情绪的调色板

# Get suggestions for a specific mood
mood_suggestion = suggest_palette_from_mood(
    mood="mysterious",
    intensity="strong"
)
# Suggests deep indigo (h: 260, s: 80, v: 30) with split-complementary

# Generate palette from suggestions
palette = generate_harmony_palette(
    base_hue=mood_suggestion["suggested_base_hue"],
    base_saturation=mood_suggestion["suggested_base_saturation"],
    base_value=mood_suggestion["suggested_base_value"],
    harmony_type=mood_suggestion["suggested_harmony_type"],
    palette_size=5
)

示例3：颜色分析

# Analyze a specific color
descriptors = hsv_to_aesthetic_descriptors(
    hue=210,
    saturation=40,
    value=70
)
# Returns:
# color_name: "Soft Sky Blue"
# mood_descriptors: ["serene", "ethereal", "contemplative", "peaceful"]
# era_associations: ["minimalist contemporary", "Scandinavian design"]
# material_suggestions: ["ceramic", "linen", "frosted glass"]
# lighting_quality: "soft diffused light, early morning"

性能特征

所有操作都是确定性的，无需成本。

与其他系统集成

HSP美学与以下元素自然融合：

• 图像生成提示：使用调色板提取将颜色理论中的提示背景化
• 语义编码美学：从参考图像中提取调色板
• 杂志摄影色彩理论指导摄影美学选择
• 诗歌视觉风格：调色板生成支持特定样式的颜色选择
• 驾驶舱设计：颜色标准遵循基于HSV的规范

设计理念

HSP美学基于以下原则运作 数学严谨性 和 语义连贯:

1. 颜色理论是确定性的 --调和关系遵循既定的数学规则
2. HSV坐标映射到感知 --色调、饱和度和值对应于人类的颜色体验
3. 语义学源于数学 --从色彩属性出发，情绪和时代联想是合乎逻辑的
4. 组合需要约束 --锁定参数可防止不连贯的颜色选择

无障碍

所有调色板都包括WCAG对比度分析：

• 在关键环境中使用前检查可访问性
• 在颜色用例上标记文本对比度不足
• 为色盲友好的构图提出替代方案

参考文献

• HSV颜色模型： 维基百科
• 色彩和谐理论： 艺术理论
• WCAG对比度指南： W3C可访问性
• 感知颜色空间： 孟塞尔和CIELAB

将来的扩展

• 感知均匀性：将HSV映射到CIELAB，以获得更准确的感知间距
• 色盲模拟：为不同的色觉缺陷生成可访问的变体
• 文化色彩语义学：情绪联想因文化背景而异
• 特定材料调色板：优化特定材料（屏幕、印刷、物理介质）的调色板
• 时间调色板演变：跟踪历史时期调色板的变化

许可证

麻省理工学院

贡献

欢迎捐款。感兴趣的领域：

• 其他和谐类型和颜色关系
• 情绪描述符的细化和扩展
• 时代协会文件
• 材质颜色映射改进
• 文化色彩语义整合

维护者

作为Lushy美学构图生态系统的一部分而建造。