Identity Forge MCP 是一款面向编码智能体的设计与品牌工作流工具，通过 MCP 协议和 CLI 提供设计系统、品牌命名与域名研究能力。
用途
它让编码智能体在开始构建之前先获得一套完整的视觉系统。用户可以选择设计套件，也可以让智能体根据产品类型和期望的氛围对目录进行排名。每个套件包含排版、语义化颜色令牌、布局、图案、注意事项，以及一份智能体可以据此构建的 DESIGN.md。
主要能力
- 浏览与选择设计套件：list_themes 可浏览目录摘要，支持按用例泳道（如 data-dashboard、saas-marketing、ecommerce-store 等 12 种）排名，使用 q 进行同义词感知的排名搜索；search_themes 返回完整目录但不排名；similar_themes 根据调色板、标签和受众查找相近套件；match_palette 根据现有品牌色按感知色距对套件排名。
- 套件导出与应用：get_design_md 获取套件的 DESIGN.md；get_tokens 支持 dtcg、css、tailwind-v3、tailwind-v4、shadcn-registry、json 六种格式；apply_theme 将 DESIGN.md、tokens 文件和 identityforge.json 戳记写入项目，默认拒绝覆盖非其写入的文件，冲突时不写入任何文件并退出非零状态。
- 字体选择：search_fonts 可按名称或类别浏览 Google Fonts 目录，或传入 like 查找相似字体；suggest_font_pairings 提供精选的标题/正文/等宽字体配对表。
- 品牌项目：create_brand_project、list_brand_projects 作为品牌变体和客户分享的容器；add_brand_variation 为项目附加提案；update_brand_variation 就地修改提案；remove_brand_variation 永久删除提案；revoke_brand_share 永久撤回客户链接；reorder_brand_variations 设置客户看到的顺序。
- 辅助集合：list_image_directions/get_image_direction 选择并导出项目图像的呈现方式；list_interface_styles/get_interface_style 选择并导出中性渲染语法；list_page_recipes/get_page_recipe 选择并导出页面论证方式。这些回答套件无法回答的问题，但不替代套件。
- 创作套件与品牌（需 kits:write 权限）：create_theme 从零创作或基于目录套件派生私有套件；remix_theme 复制套件并应用覆盖；update_theme 就地编辑已保存的套件；delete_theme 永久删除套件，若被品牌项目引用则返回 409 kit_in_use。
使用方式
安装本地 MCP 服务器到使用的客户端：支持 claude-code、cursor-vscode、codex 等，也支持 gemini、opencode、pi。通过 npx -y identityforge@latest mcp 运行同一本地 stdio 服务器，安装会合并到现有配置而非替换。安装后可用 identityforge doctor --client <name> 检查客户端是否指向滚动包并初始化 MCP 服务器。仓库还捆绑了 Agent Skill 和插件。连接后智能体可使用 63 个工具。免费套件无需密钥即可浏览，持久化项目、保存工作、认证配额或 Pro 访问需要登录，浏览器注册后 CLI 自动获得密钥。
适用场景
适合需要为产品快速建立完整视觉系统的开发团队，尤其是借助编码智能体进行构建时；也适合进行品牌命名、域名研究、客户提案分享和品牌更新的工作流。
限制
- 免费可用 69 个设计套件，Pro 解锁额外 10 个及每月 1000 次 AI 生成。
- apply_theme 默认拒绝覆盖非 stamp 记录的文件，--force 具有破坏性且不可恢复。
- 每个用例泳道的文字说明目前已全目录关闭，排名分数不带解释句。
- 图像方向、界面样式、页面配方提供的是简报，Identity Forge 不渲染图像；若当前智能体无法进行参考引导编辑，需将源图和导出方向交给产品图像工作流。
- 品牌变体删除、分享撤回等操作不可撤销。
