How darcas/refero-design-mcp works
Refero Design MCP is a stdio server for discovering public design styles, building a lazy local index, and returning parsed JSON or sectioned design.md. The main workflow checks index coverage, searches or matches styles, then retrieves a selected style through a tool or resource. Sitemap discovery, page extraction, cached state, scoring, and rendering are distinct stages; the README also documents the style-ID listing capability. Edges follow shown calls and documented source behavior; several tool implementations and extractors were not excerpted, so their internal links are omitted.
Main entry points: index.ts Tool registry · store.ts Style store · @shared.ts Tool helpers · searchStyles.ts Style search
Components 24
MCP surface
- Server assembly
src/server/index.ts - Tool registry
src/server/tools/index.ts - Style search
src/server/tools/searchStyles.ts - Style matching
src/server/tools/matchStyle.ts - Index status
src/server/tools/indexStatus.ts - Style ID listing
src/server/tools/listStyleIds.ts - Design Markdown tool
src/server/tools/getDesignMd.ts - Style JSON tool
src/server/tools/getStyle.ts - Design resource
src/server/resources/designMd.ts - Tool helpers
src/server/tools/@shared.ts
Discovery and index
- Index expansion
src/server/tools/index.ts - Style store
src/index/store.ts - Sitemap parser
src/sources/sitemap.ts
Design processing
- Page extractor
src/sources/rsc.ts - Relevance scoring
src/core/scoring.ts - Markdown renderer
src/core/designMd.ts - Markdown truncation
src/core/truncate.ts - Style schemas
src/types.ts
Runtime infrastructure
- Runtime configuration
src/config.ts - HTTP client
src/http.ts - Concurrency limiter
src/core/concurrency.ts
Other components
- MCP client
- Refero public pages
- Local cache files
Connections 37
- MCP client → Server assembly: connects via stdio
README.md - Server assembly → Tool registry: registers tools
src/server/index.ts - Server assembly → Design resource: registers resource
src/server/index.ts - Tool registry → Index status: registers
src/server/tools/index.ts - Tool registry → Style search: registers
src/server/tools/index.ts - Tool registry → Style matching: registers
src/server/tools/index.ts - Tool registry → Design Markdown tool: registers
src/server/tools/index.ts - Tool registry → Style JSON tool: registers
src/server/tools/index.ts - Tool registry → Style ID listing: registers
src/server/tools/index.ts - Tool registry → Index expansion: passes expansion
src/server/tools/index.ts - Style search → Index expansion: expands index
src/server/tools/searchStyles.ts - Style search → Style store: reads summaries
src/server/tools/searchStyles.ts - Style search → Tool helpers: ranks and formats
src/server/tools/searchStyles.ts - Style matching → Tool helpers: uses scoring helpers
src/server/tools/matchStyle.ts - Style matching → Index expansion: expands index
src/server/tools/index.ts - Index status → Tool helpers: uses tool helpers
src/server/tools/indexStatus.ts - Style ID listing → Tool helpers: uses tool helpers
src/server/tools/listStyleIds.ts - Design Markdown tool → Tool helpers: uses tool helpers
src/server/tools/getDesignMd.ts - Design Markdown tool → Markdown renderer: renders document
src/server/tools/getDesignMd.ts - Style JSON tool → Tool helpers: uses tool helpers
src/server/tools/getStyle.ts - Design resource → Style store: loads style
src/server/resources/designMd.ts - Design resource → Markdown renderer: renders document
src/server/resources/designMd.ts - Index expansion → Style store: fetches uncached styles
src/server/tools/index.ts - Index expansion → Concurrency limiter: limits parallel work
src/server/tools/index.ts - Index expansion → Runtime configuration: reads fetch limits
src/server/tools/index.ts - Style store → HTTP client: fetches pages
src/index/store.ts - Style store → Sitemap parser: parses sitemap
src/index/store.ts - Style store → Page extractor: extracts page data
src/index/store.ts - Style store → Local cache files: reads and writes cache
src/index/store.ts - Style store → Runtime configuration: uses cache settings
src/index/store.ts - Sitemap parser → HTTP client: requests sitemap
src/sources/sitemap.ts - HTTP client → Runtime configuration: uses request settings
src/http.ts - HTTP client → Refero public pages: requests public pages
README.md - Tool helpers → Relevance scoring: scores summaries
src/server/tools/@shared.ts - Markdown renderer → Markdown truncation: truncates output
src/core/designMd.ts - Markdown renderer → Style schemas: uses style structures
src/core/designMd.ts - Page extractor → Style schemas: validates extracted data
src/sources/rsc.ts