IcoGenie MCP（icogenie-mcp）是一个面向 IcoGenie 的 Model Context Protocol（MCP）服务器，目标是让 Claude 等 AI 智能体能够以编程方式生成生产就绪的 SVG 图标。
一、用途与安装方式 将本服务器添加到 Claude Desktop 配置即可使用（macOS 路径为 ~/Library/Application Support/Claude/claude_desktop_config.json）。全局安装或通过 npx 运行时，服务器会自动工作。
二、认证方式 首次使用时，MCP 服务器会：打开浏览器进行认证、要求批准访问、把会话令牌保存到 ~/.icogenie/config.json。后续使用自动完成，令牌会与 IcoGenie CLI 共享。在 CI/CD 环境中，可设置 ICOGENIE_SESSION_TOKEN 环境变量以跳过浏览器认证。
三、可用工具（Available Tools）
- generate_icon：根据文字描述生成单个图标预览。返回 { sessionId, preview, previews, creditsRemaining, sessionData, suggestions }。
- regenerate_icon：重新生成某个指定的图标变体。返回 4 个候选预览，需使用 confirm_regeneration 确认最终选择（两阶段流程）。返回 { candidates, regenToken, creditsRemaining }。
- confirm_regeneration：从 4 个候选中选定一个，完成重新生成。费用：免费（已包含在 regenerate_icon 中）。返回 { success, preview, creditsRemaining }。
- check_credits：查看当前积分余额。返回 { credits, team, user }。
- download_icon：下载某个图标或图标集的最终 SVG + PNG 包。费用：单个 5 积分，图标集为每图标 4 积分。
- normalize_bundle：根据一段描述生成经 AI 增强的图标清单，用于规划图标集。费用：免费（有速率限制）。返回 { bundleId, icons, bundleType, styleRecommendation, reasoning }。
- generate_bundle：根据图标清单生成一组图标。费用：每图标 1 积分。返回 { bundleId, iconCount, icons: [{ name, description, preview }], pricing, creditsUsed, creditsRemaining }。
- save_to_library：把生成的图标保存到个人库。返回 { success, libraryItemId }。
- list_library：列出已保存到个人库的图标。返回 { items: [{ id, name, tags, preview, createdAt }], total, page }。
- download_from_library：从个人库中下载图标，格式为 SVG + PNG。返回 { savedTo } 或 { base64, filename }。
- claim_daily_credits：领取 2 个免费积分，每 24 小时可领取一次。返回 { credited, creditsRemaining, nextClaimAt }。
四、示例工作流 单图标：先 check_credits() 查看积分；再用 generate_icon({ prompt: "notification bell icon", style: "outline" }) 生成，返回 sessionId、预览与剩余积分。如需细化，走两阶段流程：regenerate_icon({ sessionId: "abc123", index: 0, prompt: "Add a dot indicator" }) 得到 4 个候选与 regenToken，随后 confirm_regeneration({ regenToken: "tok_xyz", selectedIndex: 1 }) 确认。最后用 download_icon({ generationId: "abc123", outputPath: "./bell-icon.zip" }) 下载最终包。 图标集：先用 normalize_bundle({ description: "e-commerce app icons", targetCount: 8 }) 免费规划；再用 generate_bundle({ icons: [...], style: "outline", bundleId: "bundle_abc" }) 生成（传入 bundleId 便于追踪）；最后 download_icon({ bundleId: "xyz789", outputPath: "./ecommerce-icons.zip" }) 下载。
五、环境变量与相关资源 积分可在 www.icogenie.xyz 购买。相关资源包括 @icogenie/cli（命令行界面）、IcoGenie Web（Web 应用）、AI Agent Docs（机器可读文档）、Developer Docs（集成指南）。官方未提供关于 MCP 与 CLI、Web 具体选择场景的进一步说明。
六、适用场景与限制 适用于在支持 MCP 的 AI 客户端中，通过对话式描述批量生成与迭代 SVG 图标，并管理个人图标库。限制方面：部分工具消耗积分（下载单个 5 积分、图标集每图标 4 积分、生成图标集每图标 1 积分），重新生成与确认采用两阶段流程；免费积分每日 24 小时可领取 2 个；首次使用需浏览器认证，CI/CD 环境需设置会话令牌环境变量。其余功能细节、平台支持范围、价格与效果等，资料暂未提供。
