# Logo MCP Server

一个基于 Model Context Protocol (MCP) 的 Logo 提取服务器，可以从任何网站提取高质量的 Logo 图标。

## 功能特性

- 🎯 **智能Logo识别** - 自动识别网站中的Logo元素
- 🔍 **多种提取策略** - 支持favicon、meta标签、图片分析等多种方式
- 🎨 **AI优化处理** - 可选的Logo优化和增强功能
- 📐 **多格式输出** - 支持PNG、SVG格式输出
- 🔧 **灵活配置** - 可自定义输出尺寸和格式
- 🚀 **MCP协议** - 完全兼容Model Context Protocol标准

## 安装

### 作为MCP服务器使用

```bash
npx @pickstar-2025/logo-mcp
```

### 本地开发安装

```bash
git clone https://github.com/xtdexw/logo-mcp.git
cd logo-mcp
npm install
npm run build
```

## 使用方法

### MCP工具调用

该服务器提供两个主要的MCP工具：

#### 1. extract_logo - 提取Logo

```json
{
  "tool": "extract_logo",
  "arguments": {
    "url": "https://example.com",
    "optimize": true,
    "format": "both",
    "size": 256
  }
}
```

**参数说明：**
- `url` (必需): 要提取Logo的网站URL
- `optimize` (可选): 是否进行AI优化处理，默认为true
- `format` (可选): 输出格式，可选值：`png`、`svg`、`both`，默认为`both`
- `size` (可选): 输出图片尺寸（像素），默认为256

#### 2. analyze_logo_candidates - 分析Logo候选项

```json
{
  "tool": "analyze_logo_candidates",
  "arguments": {
    "url": "https://example.com"
  }
}
```

**参数说明：**
- `url` (必需): 要分析的网站URL

### 命令行使用

```bash
# 提取Logo
node cli.js extract https://example.com

# 分析Logo候选项
node cli.js analyze https://example.com
```

## MCP配置

在你的MCP客户端配置文件中添加：

```json
{
  "mcpServers": {
    "logo-mcp": {
      "command": "npx",
      "args": ["@pickstar-2025/logo-mcp"]
    }
  }
}
```

## 技术架构

- **TypeScript** - 类型安全的开发体验
- **MCP Protocol** - 标准化的模型上下文协议
- **Puppeteer** - 网页内容抓取和分析
- **Sharp** - 高性能图像处理
- **AI优化** - 智能Logo识别和优化

## 开发

### 构建项目

```bash
npm run build
```

### 运行测试

```bash
npm test
```

### 启动开发服务器

```bash
npm run dev
```

## API参考

### LogoExtractor类

主要的Logo提取类，提供以下方法：

- `extractLogo(url, options)` - 提取指定网站的Logo
- `analyzeCandidates(url)` - 分析网站的所有Logo候选项

### LogoOptimizer类

Logo优化处理类：

- `optimize(logoData, options)` - 优化Logo质量和格式
- `resize(logoData, size)` - 调整Logo尺寸

## 许可证

MIT License - 详见 [LICENSE](LICENSE) 文件

## 贡献

欢迎提交Issue和Pull Request！

## 更新日志

### v1.0.0
- 初始版本发布
- 支持基本的Logo提取功能
- 实现MCP协议兼容
- 添加AI优化功能

## 支持

如果你遇到任何问题，请：

1. 查看 [Issues](https://github.com/xtdexw/logo-mcp/issues)
2. 提交新的Issue描述问题
3. 联系维护者

---

Made with ❤️ by CodeBuddy