MCP LOGO GEN

🚀 MCP 工具服務器用於標誌生成

本服務器藉助 FAL AI 提供標誌生成功能，涵蓋圖像生成、背景移除以及自動縮放工具，為用戶帶來便捷的標誌製作體驗。

🚀 快速開始

安裝

1. 安裝 uv（通用虛擬環境）：

curl -LsSf https://astral.sh/uv/install.sh | sh

2. 創建並激活虛擬環境：

uv venv
source .venv/bin/activate  # 在 Unix/macOS 上
# 或者
.venv\Scripts\activate     # 在 Windows 上

3. 安裝依賴項：

uv pip install -r requirements.txt

4. 設置環境變量：
   • 在項目根目錄創建一個 .env 文件
   • 添加你的 FAL AI API 密鑰：

FAL_KEY=your_fal_ai_key_here

運行服務器

使用以下命令啟動服務器：

python run_server.py

服務器將在 http://127.0.0.1:7777 上可用。

故障排除

⚠️ 重要提示

如果在 Windows 上運行服務器時遇到 FileNotFoundError，請確保你從項目根目錄運行命令。若問題依舊存在，請更新到最新版本的代碼庫，其中包含針對 Windows 兼容性的修復。

💡 使用建議

Windows 用戶需注意：

1. 確保已激活虛擬環境 .venv\Scripts\activate。
2. 從項目根目錄運行服務器 python run_server.py。
3. 若看到任何與路徑相關的錯誤，請在倉庫的 issues 部分報告。

Cursor IDE 配置

1. 打開 Cursor 設置。
2. 轉到 MCP 部分。
3. 添加以下配置：
   • URL: http://127.0.0.1:7777/sse
   • 連接類型: SSE
   • 啟用連接。

✨ 主要特性

• 提供圖像生成、背景移除和自動縮放工具。
• 自動生成三種尺寸的標誌（原始大小、32x32 像素、128x128 像素），並以 PNG 格式保持透明度。
• 可通過編輯 server.py 文件自定義提示結構。
• 支持使用 generate_image 工具生成任意圖像，而非侷限於標誌。

📚 詳細文檔

注意事項

• 總是參考 @logo-creation.mdc 在你的 Cursor Composer 中以獲得一致的結果。
• 步驟在 @logo-creation.mdc 中定義，但工具可以獨立使用。
• 所有生成的標誌都會保存在 downloads 目錄中。
• 每個標誌會自動生成三種尺寸：
  • 原始大小
  • 32x32 像素
  • 128x128 像素
• 所有標誌都以 PNG 格式保持透明度。
• 由代理生成的提示由示例和服務器中看到的提示結構 informing。你可以通過編輯 server.py 文件來自定義提示結構。
• 你可以使用 generate_image 工具來生成任何圖像，而不僅僅是標誌。

要求

• Python 3.8+
• FAL AI API 密鑰（用於圖像生成）
• 活動互聯網連接

參考資料

• Cursor MCP 文檔
• 模型上下文協議入門
• FAL AI 儀表盤

📺 演示

如果你發現此工具有用，你可以請我喝咖啡 ☕️ 來支持開發！