Secret MCP server
io.github.yyeongjin/secret-mcp·v0.6.0Local MCP server for isolated, evidence-backed GDWEB design analysis and web search.
0 stars40 downloads/wk
Reviews
Write oneNobody has reviewed Secret MCP yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Secret MCP tools (5)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
full-web-searchSearch the web and fetch complete page content from top results. This is the most comprehensive web search tool. It searches the web and then follows the resulting links to extract their full page content, providing the most detailed and complete information available. Use get-web-search-summaries for a lightweight alternative.
generate-gdweb-design-indexesAutomatically use this tool when the user asks to find GDWEB references and create layout analysis, frontend specifications, implementation plans, or DESIGN_INDEX files. This tool applies the dashboard-managed exclusion list, performs the GDWEB search internally, and sends one completely separate MCP sampling/createMessage request per non-excluded result. Each isolated request contains only one re
get-single-web-page-contentExtract and return the full content from a single web page URL. This tool follows a provided URL and extracts the main page content. Useful for getting detailed content from a specific webpage without performing a search.
get-web-search-summariesSearch the web and return only the search result snippets/descriptions without following links to extract full page content. This is a lightweight alternative to full-web-search for when you only need brief search results. For comprehensive information, use full-web-search instead.
search-gdweb-designsUse this tool only when the user wants a lightweight list of GDWEB references. It applies the dashboard-managed exclusion list before returning results, returns metadata for multiple results, and does not generate implementation documents. For layout analysis, frontend specifications, DESIGN_INDEX files, or implementation planning, use generate-gdweb-design-indexes instead so every result is proce
Public scan report
scanner v0.1.10 · 2026-11-01 · same rubric, same numbers if you re-run it
- Code scan36 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 20 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Secret MCP compares
Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 92/100
- higher than 90% of 3,470 Web search servers
- Tools
- 5
- the typical Web search server has 5
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 40
- more than 26% of 827 Web search servers with a package
What its tools let an agent do: 4 read · 1 create
Install Secret MCP in Claude Code, Cursor or VS Code
Runs npx -y secret-design-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add secret-mcp -- npx -y secret-design-mcp
What the publisher says
From the Secret MCP repository's README, as published. We do not edit it. Read it on GitHub
English | 한국어
Target Architecture
Secret MCP
An evidence-grounded MCP server for web design analysis, screenshot-to-specification workflows, and frontend reconstruction planning.
npx -y secret-design-mcpSecret MCP is a local Model Context Protocol (MCP) server that searches GDWEB for recent design references and creates a separate LLM request and a separate DESIGNINDEX file for every search result**. Each file contains page- and route-specific layouts, navigation, pixel coordinates, colors, components, and responsive specifications traceable to the supplied visual evidence.
The name Secret MCP does not mean that the project provides secret features or private data. It was the project name used while experimenting in a private repository with the idea of building an MCP server around design websites. The project's current purpose is to extract reproducible structural evidence from public design references and turn it into one specification per work that an LLM can apply to a new project.
Images and descriptions from multiple works are never combined in a single LLM context or document. The server processes search results sequentially inside the server, creates an independent MCP sampling/createMessage request for each work, saves that work's file, and only then advances to the next work. A separate local web application lets you select one work at a time, inspect its source evidence, measured colors and coordinates, LLM contract, generation log, and final document, and manage the exclusion list for subsequent searches.
Research Note
Evidence-Isolated Multimodal Design Analysis through MCP Sampling
Working paper and implementation report · Secret MCP v0.6.0 · not peer reviewed
Abstract
Secret MCP implements an auditable pipeline for converting public webpage screenshots into implementation-oriented design specifications. The system prepares desktop and mobile visual evidence, records crop coordinates and representative pixel colors, and invokes client-side MCP sampling once per reference. Unlike workflows that concatenate several design references into one prompt, Secret MCP treats reference identity as both a request boundary and an artifact boundary: one reference produces one sampling request, one request contract, and one DESIGN_INDEX document. Each request asks for includeContext: none and applies the same 19-section specification contract covering routes, geometry, components, design tokens, responsive behavior, accessibility, implementation tasks, acceptance criteria, and uncertainty. This report evaluates protocol-level isolation and artifact production; it does not claim that one language model, prompt, or reconstruction method outperforms another. A live smoke test verifies the request boundary, while a preserved three-reference run provides descriptive measurements and a qualitative implementation case.
Research Questions
Formal System Model
For reference ri, the prepared evidence set contains image tiles I, crop bounds B, representative-color measurements P, and source metadata M. The fixed specification contract is C; the independent request and resulting document are qi and D_i.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Secret MCP: common questions
- Is Secret MCP server safe?
- Yes, by our scan: it is graded A (92/100). Read the Secret MCP safety report
- How do I install Secret MCP?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Secret MCP need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Secret MCP maintained?
- The last commit was 23 days ago (2026-10-12). The latest release is v0.6.0.
- What can I use instead of Secret MCP?
- Servers from other publishers that do the same job: Zotero MCP server, Perplexity API Platform (moved to ai.perplexity/mcp-server) and Tavily MCP server.
- How does Secret MCP compare with other Web search MCP servers?
- safety score 92/100 (higher than 90% of 3,470 Web search servers); tools 5 (the typical Web search server has 5); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Secret MCP
Same job from other publishers: the closest match first, then the best rated.
Zotero MCPSearch, read, annotate, and add to your Zotero research library, local or web.not reviewedWidely usedB- Perplexity API Platform (moved to ai.perplexity/mcp-server)Real-time web search, reasoning, and research through Perplexity's APInot reviewedWidely usedA
- TavilyMCP server for advanced web search using Tavilynot reviewedWidely usedA
- SearchMCP server for web search operationsnot reviewedEstablishedA
- Perplexity API PlatformReal-time web search, reasoning, and research through Perplexity's APInot reviewedEstablishedA
