A1 Gallery

---

A1 是一个精选真实网站设计的图库。这个 MCP 服务将图库接入你的编码 Agent，让你可以请求设计参考并获得结构化 JSON，而不必粘贴截图并描述自己的需求。

每个网站都会完整采集，拆分为内部页面和独立版块，然后进行测量。你可以获取从渲染页面中测得的字号、间距、圆角、容器宽度和配色，而不是根据图片猜测。

当前图库内容： 1,165 个网站 · 3,209 个已采集版块 · 2,860 个整页采集 · 571 种字体 · 517 位设计师和工作室。

端点

URL	https://www.a1.gallery/api/mcp
传输方式	Streamable HTTP
身份验证	OAuth 2.1 with PKCE, dynamic client registration
注册表名称	gallery.a1/a1-gallery
工具	17 个，全部为只读

使用 A1 账户即可免费访问——每天可调用工具 50 次。A1 Pro 可将限额提高到每天 2,000 次，并提高每分钟调用限额。

安装

客户端首次连接时会打开浏览器供你登录。各客户端的安装说明和一键安装链接见 a1.gallery/mcp。

Claude Code — 插件

此仓库中的插件捆绑了 MCP 服务、三个技能、三个斜杠命令和一个研究子 Agent。它会教 Agent 如何使用图库，而单独的连接器不具备这些功能。

/plugin install a1-gallery --marketplace bryntay/a1-mcp

在低于 2.1.275 的 Claude Code 版本中，请先添加 marketplace：

claude plugin marketplace add bryntay/a1-mcp
claude plugin install a1-gallery

然后运行 /mcp 并完成身份验证。有关插件新增的功能，请参见下文的插件。

Claude Code — 仅连接器

claude mcp add --transport http a1 --scope user https://www.a1.gallery/api/mcp

然后运行 /mcp，并在提示时登录。

Codex CLI

codex mcp add a1 --url https://www.a1.gallery/api/mcp

Cursor 和 Claude Desktop

{
  "mcpServers": {
    "a1": {
      "url": "https://www.a1.gallery/api/mcp"
    }
  }
}

VS Code（1.99+，搭配 GitHub Copilot）

{
  "servers": {
    "a1": {
      "type": "http",
      "url": "https://www.a1.gallery/api/mcp"
    }
  }
}

Windsurf

{
  "mcpServers": {
    "a1": {
      "serverUrl": "https://www.a1.gallery/api/mcp"
    }
  }
}

Zed（0.168+）

{
  "context_servers": {
    "a1": {
      "url": "https://www.a1.gallery/api/mcp"
    }
  }
}

你可以这样提问

• “找出三个粗野主义律所网站，并展示它们的首屏。”
• “代理机构的首屏实际使用什么字号比例？”——统计所有网站的四分位数，而非只看一个示例。
• “展示提到按用量计费的定价页面。”——在页面文案中进行全文搜索。
• “作品集常见问题中关于退款都写了什么？”——提取问答对并统计出现频次。
• “重建这个定价版块。”——提供测量得出的配色、字体、间距和圆角数值。

工具

全部 17 个工具均为只读，并标注为 readOnlyHint: true。

网站

工具	功能
search_websites	按名称、描述和分类体系进行关键词搜索。可解析别名——“SaaS”“fintech”“brutalist”会映射到实际分类词。
browse_websites	仅按类型、类别、风格、技术或颜色筛选浏览。
get_website	获取单个网站的全部信息：字体、颜色、风格、技术、创作者和版块。
get_similar_websites	显示围绕指定网站形成的灵感聚类。
get_recently_added	按发布日期降序显示最新收录内容。
get_design_filters	显示包含数量的完整分类体系——可用于构建有效筛选条件。

版块

工具	功能
search_sections	在版块文案中搜索，包括标题、常见问题解答、定价文案和客户评价。返回截图、提取的结构和测量所得的 token。
get_website_sections	某个网站按页面顺序排列的所有已采集版块。
analyze_section_content	汇总多个版块的内容模式，包括主题分布和最常见的逐字常见问题。
analyze_design_tokens	汇总测量值，包括标题字号、正文大小、比例、内边距、容器宽度、圆角的 p25/中位数/p75，以及常见字体和强调色。

页面

工具	功能
search_pages	在整个图库中查找一种页面类型，例如所有定价页面或所有关于页面。支持全文搜索。
get_website_pages	某个网站已采集的子页面。

字体和创作者

工具	功能
browse_fonts	按分类、许可证或使用该字体的网站类别浏览字体。
get_font	查看一种字体，包括分类、许可证、描述和使用次数。
find_font_pairings	查看两个字体搭配使用的真实案例。
browse_creators	按类别或风格筛选设计师和工作室。
get_creator	查看一位创作者，包括简介、链接和精选作品。

tools/list 会返回完整描述、参数和响应格式。

插件

安装连接器后，Agent 会获得 17 个工具。但它不会告诉 Agent，analyze_design_tokens 比五张截图更适合回答“这个应该做多大”，也不会说明 lowSample 标记意味着不要过度概括。插件会传达这些信息。

技能

技能	触发时机
design-reference	设计问题需要证据时使用，例如字体比例、间距、配色，或某类网站的实际做法。优先调用汇总工具，再查看示例。
section-rebuild	重建首屏主视觉、定价表或常见问题版块时使用。基于测量所得的 designTokens 构建，而不是从截图中读取数值。
setup	首次连接或遇到 401 account_required 时使用。引导完成 OAuth 和配额设置。

命令

命令	功能
/a1-gallery:reference	查找符合设计简报的真实网站，并将简报改写为图库使用的分类体系。
/a1-gallery:tokens	查看某种版块类型的测量值，以 p25–p75 范围呈现。
/a1-gallery:pairings	查找使用某种字体或字体搭配的网站。

子 Agent

design-researcher 负责处理需要多次搜索的开放式简报：先进行汇总分析，再进行几次针对性搜索，最后提供构建所需的数值。它会返回一份简报，不会编辑文件。

为什么汇总结果使用四分位数

analyze_design_tokens 报告 p25、中位数和 p75，而不是平均值。设计数值的分布往往有长尾——某个网站有一个 180px 的首屏主视觉标题，就会把均值拖到毫无用处的范围。

细分数据很快就会变少。查询商店中的定价版块时，可能只会看到少量示例。这种情况下，响应会附带 lowSample: true 并报告原始计数，而不是百分比，这样 Agent 就能说“这里有四个示例”，而不是凭空编造一个常规标准。

注意事项

网站描述和版块文案均来自第三方网站。工具描述会将其标记为不可信的外部数据。

此仓库包含清单和文档。服务端本身为闭源，并托管在 a1.gallery。

支持

问题和疑问：提交 issue 或发送邮件至 [email protected]。