Favicon MCP Server

🚀 Favicon 图标 MCP 服务器

Favicon 图标 MCP 服务器是一款用 Go 语言编写的实用工具，它能将 SVG 图像轻松转换为.ico 和.png 格式的 favicon 文件。该项目遵循标准的 Go 项目布局，借助 Go 模块进行依赖管理，为开发者提供了便捷、高效的使用体验。

🚀 快速开始

Favicon 图标 MCP 服务器使用起来十分简单。首先要确保你已经安装了 Go 语言环境和 Git，然后按照以下步骤操作，就能快速开启使用之旅。

✨ 主要特性

• 格式转换：支持将 SVG 转换为.ico 和.png 格式，满足不同场景下对 favicon 文件格式的需求。
• MCP 集成：可与 AI 工具（如 Cursor 和 Windsurf）集成，实现自动化工作流，提高开发效率。

📦 安装指南

在开始使用前，你需要进行一些必要的安装操作。请确保已经安装了 Go 语言环境和 Git，然后执行以下命令：

go mod init your_project_module
go mod tidy

💻 使用示例

基础用法

启动服务器

go run main.go

直接 SVG 输入

{
  "command": "convert",
  "input": {
    "svg_content": "<svg>...</svg>"
  }
}

SVG 文件输入

{
  "command": "file_convert", 
  "input": {
    "file_path": "/path/to/image.svg"
  }
}

高级用法

返回格式

{
  "output": {
    "icon_base64": "iVBORw0KGgoAAAANSUhEUgAAADIAAAAyCAMAAAAp4XiD... ",
    "format": ".ico,.png"
  }
}

📚 详细文档

测试方法

基本测试

# 转换 SVG 文件为 PNG 格式
go run main.go convert --input input.svg --output output.png

# 启动服务器进行交互式测试
go run main.go server

开发

项目结构

favicon-mcp-server/
├── main.go         # 主服务实现文件
├── go.mod          # Go 模块定义文件
└── README.md       # 项目说明文档

构建

go build

贡献指南

如果你想为这个项目贡献代码，可以按照以下步骤进行：

1. 克隆仓库：git clone https://github.com/yourusername/favicon-mcp-server.git
2. 创建功能分支：git checkout -b feature/amazing-feature
3. 提交更改：git commit -m '添加出色的功能'
4. 推送到远程：git push origin feature/amazing-feature
5. 发起拉取请求

集成到工具

与Windsurf集成

1. 打开Windsurf，访问Cascade界面。
2. 编辑配置文件~/.codeium/windsurf/mcp_config.json：

   "mcpServers": {
     "favicon-mcp-server": {
       "command": "go",
       "args": ["run", "main.go"],
       "cwd": "/path/to/favicon-mcp-server"
     }
   }
   

3. 刷新Windsurf以应用配置。

与Cursor集成

1. 启用MCP服务器功能。
2. 添加新MCP服务器，指定可执行文件路径：

   go run main.go
   

3. 配置完成后启用服务器。

📄 许可证

本项目采用 MIT 许可证，具体内容请参阅LICENSE文件。