MCP Mirage

mcp幻影品牌提取物

MCP（模型上下文协议）服务器，从任何网站提取品牌标识并以编程方式重新创建。

特性

• 提取品牌 -分析任何网站以提取颜色、排版、间距和按钮样式
• 生成副本 -使用提取的品牌数据创建HTML/CSS组件
• 复制网站 -一步提取和生成
• 比较品牌 -比较两个网站之间的品牌标识
• 应用于模板 -使用提取的品牌生成预构建模板

需求

• Python 3.11+
• Firecrawl API密钥(在这里买一个)
• Google Generative AI API密钥(在这里买一个)

安装

使用紫外线（推荐）

cd mcp-mirage-brand-extract
uv pip install -e .

使用pip

cd mcp-mirage-brand-extract
pip install -e .

配置

1. 复制环境模板：

cp .env.example .env

1. 将API密钥添加到 .env:

FIRECRAWL_API_KEY=your_firecrawl_key
GOOGLE_API_KEY=your_google_key

用法

运行服务器

# With uv
uv run python server.py

# Or directly
python server.py

MCP检验员测试

mcp dev server.py

添加到Claude桌面

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "mirage-brandextract": {
      "command": "python",
      "args": ["/path/to/mirage-brandextract-mcp/server.py"],
      "env": {
        "FIRECRAWL_API_KEY": "your_key",
        "GOOGLE_API_KEY": "your_key"
      }
    }
  }
}

工具

extract_brand

从网站中提取完整的品牌标识。

# Parameters
url: str                      # Target website URL
include_screenshots: bool     # Include visual screenshots (default: False)

# Returns
{
    "colors": {
        "primary": "#FF5A5F",
        "secondary": "#00A699",
        "palette": [...]
    },
    "typography": {
        "headings": "Circular",
        "body": "Circular",
        "weights": [400, 500, 700]
    },
    "spacing": {...},
    "buttons": {...},
    "url": "original_url"
}

generate_replica

使用提取的品牌数据生成HTML/CSS。

# Parameters
brand_data: dict          # Output from extract_brand
component_type: str       # "landing_page", "email", "button", "card"
customization: str        # Additional instructions

# Returns
{
    "html": "
...
",
    "css": "/* styles */",
    "preview_url": "data:text/html;base64,..."
}

replicate_website

完整的工作流程：一步提取品牌+生成复制品。

# Parameters
url: str              # Target website URL
component_type: str   # What to generate
customization: str    # Additional instructions

# Returns
{
    "brand_data": {...},
    "generated": {
        "html": "...",
        "css": "..."
    }
}

compare_brands

比较两个网站的品牌标识。

# Parameters
url1: str    # First website URL
url2: str    # Second website URL

# Returns
{
    "site1": {...brand_data...},
    "site2": {...brand_data...},
    "comparison": {
        "color_similarity": 0.85,
        "typography_match": true,
        "font_overlap": ["Inter"],
        "differences": [...]
    }
}

apply_brand_to_template

将品牌应用于预构建的模板。

# Parameters
url: str              # Source website for branding
template_type: str    # "hero_section", "pricing_table", "feature_grid", "testimonial", "cta"

# Returns
{
    "html": "...",
    "css": "...",
    "preview_url": "...",
    "template_type": "hero_section"
}

示例用例

1.提取Airbnb品牌并创建英雄部分

extract_brand(url="https://airbnb.com")
generate_replica(brand_data=result, component_type="landing_page", customization="Focus on hero section")

2.比较竞争对手网站

compare_brands(url1="https://airbnb.com", url2="https://vrbo.com")

3.快速生成模板

apply_brand_to_template(url="https://stripe.com", template_type="pricing_table")

发展

运行测试

pytest tests/ -v

代码格式化

black src/ tests/
ruff check src/ tests/

许可证

麻省理工学院

______________________________________________________________________

*自主建造 钢锁 -自主MCP服务器工厂*