Refero MCP

使用纯英文搜索 styles.refero.design，并将 DESIGN.md 放入任何项目中。

快速导航

这是什么

Refero Styles 是一个包含约 200 个精选网站的测试版目录，有人已经完成了提取颜色、排版、间距以及各风格“做/不做”指南的繁重工作。每个条目都附带一个 designSystem 块，基本上就是一个等待生成的 DESIGN.md。

此 MCP 封装了该目录，以便 Claude Code 可以用自然语言搜索它，并将生成的 DESIGN.md 直接放入你正在构建的任何项目中。无需浏览器标签页 JSON 复制粘贴，也无需手动编写标记表。

它适用于任何使用 Claude Code 启动新应用、演示文稿或客户项目的用户，他们希望在渲染第一个组件之前就锁定设计语言。

快速安装

一行代码：

claude mcp add refero -- npx -y fidgetcoding-refero-mcp

重启 Claude Code 并开始描述你想要的风格。

如果你想要“氛围搜索”（针对每个风格诗意的 northStar 摘要进行语义排名），请传入 OpenAI 密钥：

claude mcp add refero --env OPENAI_API_KEY=sk-... -- npx -y fidgetcoding-refero-mcp

如果没有密钥，搜索将回退到关键词评分。效果依然不错，只是没那么神奇。

对于 claude_desktop_config.json 用户：

{
  "mcpServers": {
    "refero": {
      "command": "npx",
      "args": ["-y", "fidgetcoding-refero-mcp"],
      "env": {
        "OPENAI_API_KEY": "sk-...",
        "REFERO_MCP_VAULT_DIR": "/absolute/path/to/your/vault"
      }
    }
  }
}

使用方法

一些可以清晰路由的提示词：

"Find me a dark editorial style with a serif and a warm accent."

"Pull the full breakdown for Linear."

"What's similar to Vercel in the Refero catalog?"

"Render Cursor's DESIGN.md — don't save it yet, just show me."

"Save Cursor's DESIGN.md into my PARZVL project."

"Show me only dark-mode brutalist styles, top five."

"Refresh the Refero catalog before we start the design pass."

更多实战配方请见 docs/USAGE.md。

工具

配置

所有内容都是可选的。默认值已选定，以便 MCP 可以直接运行。

仓库根目录附带一个可复制粘贴的 .env.example。

REFERO_MCP_VAULT_DIR 没有默认值。之前的草稿硬编码了我的笔记本电脑路径，这对于地球上仅一台机器来说效果很好。审阅者发现了这一点。现在如果你不设置它，工具就会拒绝写入——虽然粗鲁，但总比把文件丢进你电脑上不存在的文件夹里要好。

工作原理

截至撰写本文时，没有公开的 Refero API 文档——其形状是根据实时站点凭经验映射的。完整的细分在 docs/api-surface.md 中，以便未来的我不会重新发现它。

• 本地目录镜像。 Refero 公开了 ?page=N 分页，但静默忽略了 ?search=、?q= 和 ?colorScheme=。因此，此 MCP 会遍历页面一次，将它们镜像到本地 REFERO_CACHE_DIR 下，并在客户端运行所有过滤和排名。

• 通过 northStar 进行氛围搜索。 每个 Refero 风格都附带一个名为 northStar 的一行诗意摘要。设置 OPENAI_API_KEY 后，MCP 会使用 text-embedding-3-small 对这些摘要进行嵌入，并根据与你查询的余弦相似度进行排名。如果没有密钥，它会回退到 northStar + 标签 + 站点名称的关键词评分。

• 本地生成 DESIGN.md。 Refero 没有公开 /design.md 端点。MCP 从 style.fullResult.designSystem（做、不做、标签、主题、角色标记颜色）中合成一个。输出与 /stitch-design-taste 和 /design-taste-frontend 技能兼容。

故障排除

“未找到风格” / 目录感觉为空。 首次运行会命中冷缓存。让 Claude “刷新 Refero 目录”一次——它会以 250ms 的礼貌间隔遍历约 10 页，并将它们写入 REFERO_CACHE_DIR。之后，搜索就是即时的。

搜索结果感觉更像关键词而不是语义。 你可能没有设置 OPENAI_API_KEY。将其添加到你的 MCP 配置并重启，或者更多地利用目录的词汇（行业加上标签，如 editorial、brutalist、glass）。

refero_design_md 返回 markdown 但无法写入磁盘。 REFERO_MCP_VAULT_DIR 未设置。将其设置为你的库根目录（绝对路径），工具将写入 <vault>/05-Projects/<NAME>/DESIGN.md。如果没有它，你会在对话中收到 markdown，可以将其粘贴到任何地方。

许可

MIT — 详情请参阅 LICENSE。

作者

由 Nate Davidovich / Lorecraft LLC 构建。

• GitHub: lorecraft-io

• npm: lorecraft

• 姊妹项目: morgen-mcp, motion-mcp

⤴ 回到顶部

安全性：gitleaks 扫描

此仓库附带一个 .gitleaks.toml 配置和一个 scripts/security-scan.sh 辅助脚本，用于扫描工作树中的机密信息（GitHub 令牌、API 密钥、JWT、私钥、Anthropic 密钥等）。

bash scripts/security-scan.sh

一个 .husky/pre-commit 钩子也会在每次提交时运行 gitleaks protect --staged，如果本地未安装 gitleaks，则会发出警告。

如果你还没有安装它：

• macOS: brew install gitleaks

• Linux: https://github.com/gitleaks/gitleaks/releases