Svg Generator MCP

SVG生成器MCP服务器

人工智能驱动的MCP服务器，用于使用FLUX/MFLUX生成高质量的SVG插图，并具有自动依赖关系管理功能。

快速开始

🚀 一个命令设置

使用uvx安装和配置（推荐）：

# Install using uvx (automatically handles all dependencies)
uvx svg-generator-mcp

添加到您的MCP客户端配置中（以Claude Desktop为例）：

{
  "mcpServers": {
    "svg-generator": {
      "command": "uvx",
      "args": ["svg-generator-mcp"]
    }
  }
}

就是这样！ 服务器立即启动自动依赖关系管理。

🐍 替代方案：直接安装Python

# Install from PyPI
pip install svg-generator-mcp

# Run directly
svg-generator-mcp

pip安装的Claude桌面配置：

{
  "mcpServers": {
    "svg-generator": {
      "command": "svg-generator-mcp"
    }
  }
}

先决条件

• Python 3.8+ - 安装Python
• Node.js 18+ - （用于AI处理）
• MCP客户端 -任何与模型上下文协议兼容的客户端

💡 uvx自动管理依赖关系 -Node.js deps在首次运行时安装

可用工具

核心工具

• generate_svg_illustration -根据文本提示生成SVG插图
• optimize_svg -优化SVG文件以实现更小的大小和更好的性能
• list_available_models -列出AI模型及其状态
• get_generation_history -获取最近一代历史记录

示例用法

生成矢量插图：

{
  "prompt": "A minimalist mountain landscape with geometric trees",
  "style": "vector",
  "width": 1024,
  "height": 512
}

配置选项

参数 generate_svg_illustration

• prompt （必填）：所需插图的描述
• style （可选）：“矢量”、“激光”或“彩色”（默认：“矢量）
• width/height （可选）：像素大小，64-2048（默认值：512）
• steps （可选）：质量步骤，1-50（默认值：20）
• guidance_scale （可选）：AI引导，1-20（默认值：7.5）
• seed （可选）：随机种子以获得可重复的结果

发展

入门指南

对于想要修改服务器的贡献者：

git clone https://github.com/aloshy-ai/svg-generator-mcp.git
cd svg-generator-mcp
npm install
npm test
npm run dev

🔄 CI/CD管道

自动化的GitHub Actions管道可确保代码质量和无缝部署：

• ✅ 自动化测试 -每次推送和PR都有完整的测试套件
• 🐍 PyPI出版 -Python包发布到 PyPI
• 🏗️ 与跨平台支持 -适用于macOS、Linux和Windows
• 🔒 安全扫描 -使用npm审计进行漏洞扫描
• 📦 自动发布 -标签发布触发生产构建

安装开发版本： pip install svg-generator-mcp

🧠 运作原理

1. 🎨 风格分析 -及时分析所需的视觉风格和构图
2. ⚡ 人工智能一代 -FLUX/MFLUX具有优化的后端，可创建高质量的图像
3. 🔧 SVG转换 -图像转换为优化的SVG格式
4. 📄 交付 -通过MCP协议向您的客户端交付干净的SVG

🛠️ 技术栈

• 后端：具有干净服务层架构的TypeScript
• AI模型：具有架构优化后端的FLUX/MFLUX（MFLUX适用于Apple Silicon，FLUX适用于Intel/AMD）
• 处理：Sharp用于图像优化和SVG转换
• 协议：具有stdio传输的模型上下文协议（MCP）
• 部署：使用uvx进行Python打包，以实现自动依赖管理
• CI/CD：使用PyPI发布和自动化测试的GitHub操作

🔧 故障排除

常见问题

安装问题

• 未找到uvx：安装 pip install pipx && pipx install uv
• Python版本：需要Python 3.8+。与核对 python --version
• Node.js缺失：从以下位置安装Node.js 18+
• 权限错误：试试 pip install --user svg-generator-mcp 相反

MCP连接问题

• 服务器未启动：检查Python和Node.js是否都在PATH中
• 工具未出现：验证MCP客户端配置语法
• 发电故障：服务器在没有AI模型的情况下以演示模式运行-这很正常
• 首次启动缓慢：首次运行时安装Node.js依赖项（1-2分钟）

AI生成问题

• 仅演示模式：如果需要，手动安装AI依赖项：

- 苹果硅： pip install mflux - 其他平台： pip install torch diffusers transformers

• 模型下载失败：AI功能是可选的-服务器在没有它们的情况下工作

获取帮助

• 📋 检查 问题 常见问题
• 🐛 报告错误 如果你找到一个
• 💡 请求功能 用于增强功能

许可证

麻省理工学院

▄▀█ █░░ █▀█ █▀ █░█ █▄█ ░ ▄▀█ █
█▀█ █▄▄ █▄█ ▄█ █▀█ ░█░ ▄ █▀█ █