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 分