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文件。