{
  "markdown": "<!-- mcp-name: io.github.Yuni9959/wrapguard-mcp -->\n\n# WrapGuard MCP\n\nWrapGuard is an MCP server and CLI that renders responsive pages with Playwright and finds Korean or English words split across visual lines. It also reports hard newlines embedded inside words, such as `업로↵드`, without rewriting immutable source evidence.\n\n한글·영어 문장이 반응형 화면에서 단어 중간에 잘리는 문제를 실제 브라우저 좌표로 검사합니다. 표시 이름은 자유롭게 바꿀 수 있지만 npm/GitHub/MCP Registry의 패키지 식별자는 별도로 유지됩니다.\n\n## What it checks\n\n- Korean eojeol-like tokens and English word tokens, including apostrophes and hyphens\n- Actual grapheme positions across 320, 375, 768, and 1024 px by default\n- Avoidable mid-word wraps versus unavoidable long identifiers\n- Hard source newlines between letters\n- Applied wrapping CSS and same-origin matching rules\n- Explicit, dry-run-first CSS suggestions\n\nURLs, code, hashes, and immutable raw evidence can be excluded with patterns or `data-wrapguard-ignore`. Public fixtures contain no private data.\n\n## Install and run locally\n\nRequirements: Node.js 22 or newer and a Playwright Chromium installation.\n\n```bash\nnpm install\nnpx playwright install chromium\nnpm run build\nnode dist/stdio.js\n```\n\nWith `browserChannel: \"auto\"` (the default), WrapGuard tries Playwright Chromium first and then an installed Chrome or Microsoft Edge. Installing Playwright Chromium is the reproducible choice for CI.\n\nAfter an npm release, an MCP client can launch it directly:\n\n```json\n{\n  \"mcpServers\": {\n    \"wrapguard\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"wrapguard-mcp\"],\n      \"env\": {\n        \"WRAPGUARD_SERVER_NAME\": \"My Typography Inspector\",\n        \"WRAPGUARD_CONFIG\": \"C:/absolute/path/wrapguard.config.json\"\n      }\n    }\n  }\n}\n```\n\nOn Windows, clients that do not resolve command shims may need `npx.cmd` instead of `npx`.\n\nRun it as a release gate without MCP:\n\n```bash\nwrapguard audit ./dist/index.html --viewports 320,375,768,1024 --output wrap-report.json\nwrapguard audit ./dist/index.html --format markdown --output wrap-report.md\n```\n\nExit code `0` means no avoidable split, `1` means regression issues were found, and `2` means the audit could not run.\n\n## Change the displayed name\n\nCopy `wrapguard.config.example.json` to `wrapguard.config.json`, then edit:\n\n```json\n{\n  \"serverName\": \"우리집 문장 검사기\"\n}\n```\n\n`WRAPGUARD_SERVER_NAME` overrides the JSON value. This changes the runtime MCP display name only. Before the first public release, change `name`, `mcpName`, repository URLs, and `server.json` together if you want a different permanent package identity.\n\n## MCP tools\n\n- `server_info`\n- `audit_page`\n- `detect_midword_breaks`\n- `inspect_wrap_css`\n- `suggest_wrap_fix`\n- `verify_wrap_regression`\n- `apply_wrap_fix` — dry-run by default; real writes require `allowWrites: true` and an allowed root\n\n## Safe defaults\n\nThe default configuration audits local files under the configured roots and localhost only. Remote URL auditing, screenshots, and CSS writes are disabled unless explicitly enabled. A hosted instance should use a narrow `allowedHosts` list because unrestricted browser navigation creates an SSRF risk.\n\nCSS previews, CSS writes, and screenshots resolve filesystem links before checking `allowedFileRoots`. Screenshot directories must be inside an existing allowed root. An explicitly selected configuration file must exist and contain a JSON object; a missing conventional `wrapguard.config.json` still uses defaults. Runtime and MCP versions are read from `package.json`.\n\n## Three publication layers\n\n1. **GitHub** publishes source, issues, documentation, and releases. It does not by itself run an MCP endpoint.\n2. **npm** publishes the stdio executable so users can run `npx -y wrapguard-mcp`.\n3. **Remote MCP** hosts `/mcp` over Streamable HTTP for clients that do not run local processes.\n\n### Publish source and npm\n\nAfter reviewing the repository name and public contents:\n\n```bash\ngit init\ngit add .\ngit commit -m \"feat: release WrapGuard MCP 0.1.1\"\ngh repo create wrapguard-mcp --public --source . --remote origin --push\nnpm login\nnpm publish --access public\n```\n\nThen validate and publish `server.json` with the official `mcp-publisher`. The npm package must be published first and the `mcpName` in `package.json` must match `server.json`.\n\n### Host a remote endpoint\n\nThe included container starts the Streamable HTTP server at `/mcp`:\n\n```bash\ndocker build -t wrapguard-mcp:0.1.1 .\ndocker run --rm -p 8787:8787 \\\n  -e WRAPGUARD_HTTP_TOKEN=\"replace-with-a-long-random-value\" \\\n  -e WRAPGUARD_HTTP_HOSTS=\"localhost,127.0.0.1\" \\\n  wrapguard-mcp:0.1.1\n```\n\nFor a public host, set `WRAPGUARD_HTTP_HOSTS` to the deployed domain and store `WRAPGUARD_HTTP_TOKEN` as a platform secret. Use a container service that supports Playwright/Chromium, such as Cloud Run, Fly.io, Render, Railway, or an equivalent service. Add the final HTTPS URL to the `remotes` field in `server.json` only after the endpoint exists.\n\nVercel Functions are not the default recommendation for this project because browser binaries, execution duration, and memory limits make browser audits less predictable than a long-running container.\n\n## Development\n\n```bash\nnpm run check\nnpm test\nnpm run build\nnpm pack --dry-run\n```\n\nThe test suite uses synthetic Korean and English pages and an in-memory MCP client/server connection.\n\n## License\n\nMIT\n",
  "bytes": 5324,
  "sha": "94a0282e097f5294992459c78b2d93b2f905dee9cbfd831b5269281562395e7a",
  "repo_slug": "yuni9959/wrapguard-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_yuni9959_wrapguard_mcp_49e0baaa/readme"
}