logo-mcp

一个智能Logo提取和分析的MCP（Model Context Protocol）服务器，支持从网站URL自动识别并提取Logo图标，并提供详细的Logo分析功能。

功能特性

🎯 智能Logo提取

多源识别：支持从favicon、Apple Touch图标、OpenGraph图像、CSS类名等多种方式提取Logo
智能评分：自动评估候选Logo质量，选择最佳版本
格式支持：支持PNG、JPG、SVG等多种图像格式
尺寸优化：自动选择合适尺寸的Logo版本

📊 Logo分析

详细信息：提供Logo尺寸、格式、类型等完整信息
多候选比较：显示所有可能的Logo候选项及其评分
质量评估：自动评估Logo图像质量和可用性
快速URL获取：支持直接获取最佳Logo的URL地址

安装使用

作为MCP服务器使用

安装依赖：

npm install @lucianaib/logo-mcp

在MCP客户端配置中添加：

{ "mcpServers": { "logo-mcp": { "command": "npx", "args": ["@lucianaib/logo-mcp"] } } }

![CodeBuddy 配置成功示例.png](src\CodeBuddy 配置成功示例.png)

开发环境设置

克隆仓库：

git clone https://github.com/lfrbmw/Logo-MCP.git cd Logo-MCP

安装依赖：

npm install

构建项目：

npm run build

启动开发服务器：

npm run dev

MCP工具

使用示例：

使用mcp提取 https://juejin.cn/的 Logo

get_best_logo_url

从网站提取并返回最佳Logo的URL地址，适用于只需要获取最佳Logo URL的场景

参数：

url (必需): 要分析的网站URL

示例：

{ "name": "get_best_logo_url", "arguments": { "url": "https://www.google.com" } }

analyze_logo

分析Logo的基本信息（尺寸、格式、质量等），支持onlyBestUrl参数只返回最佳Logo的URL

参数：

url (必需): 要分析的网站URL
onlyBestUrl (可选): 是否只返回最佳Logo的URL，默认为false

示例：

{ "name": "analyze_logo", "arguments": { "url": "https://www.github.com", "onlyBestUrl": false } }

技术架构

核心模块

LogoExtractor: 负责从网站提取Logo候选项，实现多源识别和智能评分算法
ImageProcessor: 提供图像处理功能，包括格式转换、尺寸调整和质量增强

依赖库

@modelcontextprotocol/sdk: MCP协议支持，提供服务器和通信框架
axios: HTTP请求处理，用于获取网站内容和下载Logo图像
cheerio: HTML解析，用于从网页中提取Logo相关信息
sharp: 图像处理，提供格式转换、尺寸调整和增强功能
image-size: 图像尺寸检测，用于获取Logo图像的尺寸信息
url-parse: URL解析，用于处理和规范化网站URL
mime-types: MIME类型检测，用于识别图像文件格式

Logo提取策略

1. 多源候选提取

Favicon链接 (<link rel="icon">)
Apple Touch图标 (<link rel="apple-touch-icon">)
OpenGraph图像 (<meta property="og:image">)
CSS类名识别 (.logo, #logo, .brand等)
品牌相关图像

2. 智能评分算法

类型权重：Logo类名 > Apple Touch > Favicon > 品牌图像 > OG图像
尺寸评分：偏好32-512px的正方形或接近正方形图像
质量检测：过滤损坏或空白图像

3. 最佳选择

根据综合评分自动选择最符合主视觉的Logo版本

Logo分析流程

1. 多源提取

HTML解析: 从页面meta标签提取favicon、apple-touch-icon等
CSS分析: 通过类名和ID识别可能的Logo元素
OpenGraph: 解析OG图像标签获取社交媒体使用的Logo
智能检测: 识别页面上可能的品牌标识元素

2. 候选评分

类型权重: 根据来源类型分配权重（如明确的logo类名权重更高）
尺寸分析: 评估图像尺寸是否适合作为Logo（32px-512px范围内）
宽高比: 优先选择接近正方形的图像
质量检测: 检查图像是否损坏或过于模糊

3. 结果输出

详细分析: 提供所有候选项的详细信息及评分
最佳推荐: 根据综合评分推荐最合适的Logo
快速获取: 支持直接返回最佳Logo的URL地址

错误处理

网络错误：超时重试和友好提示
图像损坏：自动检测和跳过
格式不支持：清晰的错误信息
无Logo情况：返回友好的无结果提示

性能优化

并发处理：多候选Logo并行验证
缓存机制：避免重复下载
内存管理：及时释放图像缓冲区
超时控制：防止长时间阻塞

贡献指南

Fork项目
创建功能分支 (git checkout -b feature/AmazingFeature)
提交更改 (git commit -m 'Add some AmazingFeature')
推送到分支 (git push origin feature/AmazingFeature)
打开Pull Request

许可证

本项目采用MIT许可证 - 查看 LICENSE 文件了解详情

作者

lucianaib - GitHub

支持

如果您遇到问题或有功能建议，请在 GitHub Issues 中提出。

Logo MCP - 让Logo提取变得简单智能 🚀

Logo MCP