Inspo

io.github.Nutlope由 GitHub 账号 Nutlope 发布v0.1.16更新于 Nov 2, 2026

Real production websites for coding agents: palettes, fonts, fold autopsies and reference JSX.

已验证Streamable HTTP可网页运行开发者工具媒体与设计

概览

AI 生成的概览

让编程助手在写界面之前研究真实上线网站——配色、字体、版式与可复制的参考 JSX。

可以做什么
  • 搜索并读取已采集的网站页面,含配色、字体、组件与图片地址
  • 获取单个页面的完整记录、其 DESIGN.md 设计系统以及该站点的页面流程
  • 查找相似页面、接近某个十六进制颜色的站点、某类宏观版式的实例,并对比 2 至 4 个站点
  • 浏览编辑精选合集,列出筛选器接受的全部取值
  • 查找使用某类 UI 组件的真实站点,并列出标准参考组件索引
  • 获取参考组件的可复制 JSX,或用一次 recommend 调用按需求简报生成完整设计包
适用场景
适合助手在搭建或改版网页界面时使用:需要真实可考的设计参考,例如挑选版式原型、匹配品牌色,或复用成熟的 hero、定价、页脚模式,而不是凭空设计。
运行要求
可使用托管的 Streamable HTTP 端点,或在本地用 Node.js 运行 npm 包 inspo-mcp。可选环境变量:INSPO_CATALOGUE_URL、INSPO_IMAGES、INSPO_MAX_TOKENS、INSPO_PROFILE。可选的 TOGETHER_API_KEY 用于启用基于嵌入的语义搜索,其余工具无需它即可使用。未声明需要账号或身份验证。
安装前请注意
工具被描述为只读,但 get_design_system 在 live=true 时会联网抓取来源站点。托管端点会记录每次调用的工具名、成功与否和耗时。参考 JSX 与截图来自第三方网站,版权归其设计者所有,正式使用前请确认授权。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Inspo,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.Nutlope%2Finspo/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "inspo": {
      "type": "http",
      "url": "https://inspomcp.dev/api/mcp"
    }
  }
}

README

[Inspo]

Inspo

Real production websites your coding agent can study, over MCP, before it writes UI. inspomcp.dev

With and without

Same brief, same model, no design skill on either run. The only difference: the page on the right was built with Inspo MCP on the session.

[The bare agent's page: dark theme, neon accent, gradient app mock] [The page built with Inspo: warm paper, editorial type, detailed product mock]

That gap is the product. Agents have tools but not taste, and the open web already holds every reference they need: Inspo assembles, tags, and addresses it.

What's inside

  • 2,320 pages across 832 real sites, each captured on desktop and mobile, with traced palettes, real fonts, detected tech, and a fold-by-fold autopsy on every page.
  • 68 canonical reference components (heroes, pricing, footers, navs, and more), each demonstrating one named macrostructure, with copy-pasteable JSX.
  • A DESIGN.md for every site, extracted from its DOM: semantic palette roles, type ramp, spacing scale, CSS variables, container width.

Fifteen tools expose all of it; recommend(brief) composes most of them into one call. The full tool table lives in apps/mcp/README.md.

Tech stack

  • TypeScript MCP server with two transports: stdio via npm, and Streamable HTTP served by the site's own Vercel deployment. No database at query time; the catalogue ships as a static seed.
  • Next.js 16 + Tailwind v4 gallery: the archive browser and the curator dashboard.
  • Playwright capture worker: desktop and mobile shots, palette, type ramp and CSS variable extraction, tag and autopsy passes via Together AI.
  • Together AI embeddings behind semantic search and find_similar.
  • A smoke harness that boots the server in-process and exercises the core tools.

Cloning & running

  1. One command, any client: npx -y inspo-mcp install (detects Claude Code, Cursor, Codex, VS Code, Windsurf, Zed, Claude Desktop and writes the config; --dry-run shows the plan)
  2. Or point a client at the hosted endpoint yourself: claude mcp add --transport http inspo https://inspomcp.dev/api/mcp
  3. Or clone: git clone https://github.com/Nutlope/inspo.git && cd inspo && pnpm install
  4. Gallery: pnpm dev, then open localhost:3000
  5. Dev loop: pnpm --filter @inspo/mcp test

Per-client snippets (Cursor, Windsurf, Zed, Claude Desktop) are on the MCP page; the self-host runbook is DEPLOY.md.

Roadmap

  • show the desktop and mobile capture side by side on every screen page
  • backfill component crops so find_components returns a crop for every hit
  • paginate the list tools instead of capping them
  • re-shoot the mobile set at retina scale
  • Accounts and paywalls are skipped on purpose: the archive is more useful free.

Want a site in the archive? Append it to apps/worker/src/seed-urls.ts and open a PR. The bar: does it make the archive better for someone building a website?

Security

Every tool is read-only. The one path that touches the outside world - get_design_system(live:true), which supplements thin captured tokens from the screen's own source - passes each URL and redirect through an SSRF guard: public named hosts only, ports 80 and 443, byte-capped body, no JS execution. The hosted endpoint logs tool name, success and duration per call, never IPs or query text.

MIT, copyright Together AI and contributors. The screenshots remain the work of their designers: every screen credits and links its source, and takedowns are honoured at /dmca.

来源:README.md,提交 5d2f4ea

工具

15

search_screens

Search the archive of real website screenshots. Returns screens with palette, fonts, components and image URLs.

输入参数modevibecolorlimitquerystyledetaildeviceindustrypageTypeaccentHuemaxTokens另有 3 个

get_screen

Fetch the full record for one screen by slug - every viewport variant, palette, fonts, tech stack, designer credit.

输入参数slug必填

get_design_system

The full DESIGN.md for one screen - real fonts, frequency-ranked palette, CSS variables, detected tech, colour roles, type ramp. Thin captured tokens are supplemented by a live fetch of the source; `live=false` skips that.

输入参数liveslug必填

find_similar

A screen's nearest design neighbours - ranked by design-similarity embeddings where available, else by macrostructure / industry / style overlap. One result per site.

输入参数slug必填limitdetailsameSitemaxTokens

compare

Compare 2-4 captured sites across palette, typefaces, macrostructure, mode, style tags, type/spacing/radius scales and container width. Returns per-site breakdowns plus what they share - triangulates a house style from a few references.

输入参数slugs必填

find_by_color

Real sites whose extracted palette sits near a hex colour (OKLAB distance, so 'close' means the same colour family, not just the same hue). Use when a brief names a brand colour.

输入参数hex必填limitdetailmaxTokenstolerance

find_examples_for_macrostructure

Real sites exemplifying one of the 19 named macrostructures. Call it at the macrostructure-pick step. Accepts slugs ('bento-grid') or display names ('Bento Grid').

输入参数name必填limitdetaildevicemaxTokens

list_collections

List every editor-curated issue. Use this for thematic browsing - e.g. all 'Editorial Layouts' or 'Dark Product Pages'.

无需输入参数。

get_filters

Every value the filters accept: styles, industries, macrostructures, modes, vibes, colors, page types, component types. Zero input. Call it when unsure - an out-of-vocabulary value errors.

无需输入参数。

get_site_pages

A site's captured pages as an ordered flow (landing → pricing → features → ...) with titles, northstars and thumbnails - how a real product sequences its pages. No arguments returns the directory of flow-capable sites. Accepts a site or screen slug.

输入参数limitsiteSlugmaxTokens

find_components

Real sites featuring a specific UI component (hero, pricing, features, cta, nav, footer, testimonial, logo-cloud, faq, stat), with a per-element crop where one exists. For copy-pasteable code use get_reference_jsx.

输入参数modetype必填vibecolorlimitstyledeviceindustrypageTypemaxTokensmacrostructure

get_collection

Fetch one issue by slug, including the editor's blurb and ordered screen list.

输入参数slug必填detailmaxTokens

find_reference_components

The canonical reference components as an index: id, label, macrostructure and a note for each hero / pricing / cta / nav / footer archetype. Pick one, then get_reference_jsx(type, id) for its source.

输入参数typemacro

recommend

Orchestrator - start here for a brief. One call returns a macrostructure pick, 5 real exemplars, matching reference components (source via get_reference_jsx), a palette suggestion, and an `evidence` packet measuring the genre's paper band / display class / accent hue. Pass a macrostructure to skip the pick step. No LLM call.

输入参数modevibebrief必填colordetaildevicepageTypemaxTokensmacrostructure

get_reference_jsx

The full canonical JSX source for one reference component, including the header stamp naming its macrostructure / theme / states. Copy-pasteable; tweak tokens to the target brand.

输入参数id必填type必填

版本历史

1
  1. v0.1.16最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分