{"_id":"remixicon-mcp","_rev":"3-2fe1fbec14cdcffed3bccf63c9bfe5f5","name":"remixicon-mcp","dist-tags":{"latest":"2.0.0"},"versions":{"1.0.0":{"name":"remixicon-mcp","version":"1.0.0","keywords":["remixicon","mcp","mcp-server","icons","icon-search","keyword-search","model-context-protocol","ai","llm"],"author":{"name":"Frad LEE","email":"fradser@gmail.com"},"license":"MIT","_id":"remixicon-mcp@1.0.0","maintainers":[{"name":"fradser","email":"fradser@gmail.com"}],"homepage":"https://github.com/Remix-Design/RemixIcon-MCP#readme","bugs":{"url":"https://github.com/Remix-Design/RemixIcon-MCP/issues"},"bin":{"remixicon-mcp":"bin/run.cjs"},"dist":{"shasum":"55eb3e2aece0803400645f9267be28a3b42857e3","tarball":"https://registry.npmjs.org/remixicon-mcp/-/remixicon-mcp-1.0.0.tgz","fileCount":18,"integrity":"sha512-yNr9XVB1/b0C7qG5UzEF3m2qQoQkqgf9+B6BvhGtekDpZu/hlMpB8d0bp9WvS3pvlIqtjbxNaSsyqpJRmvG3WA==","signatures":[{"sig":"MEYCIQCb18xVIkwfZJmhz2CX5ahpH8UdkS1LI8eYGZcBNNf+DAIhAJh9ghtw6yTVa8y0nYwyBu48RwM+eUxND8mCQQwQPC2e","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":184054},"main":"src/index.ts","engines":{"node":">=18.0.0"},"gitHead":"785693abdc88e4cba8143a155e58cb9a615b5e16","scripts":{"lint":"biome lint --write","test":"vitest","build":"tsc --noEmit","format":"biome format --write","typecheck":"tsc --noEmit"},"_npmUser":{"name":"fradser","email":"fradser@gmail.com"},"repository":{"url":"git+https://github.com/Remix-Design/RemixIcon-MCP.git","type":"git"},"_npmVersion":"11.6.0","description":"Lightweight MCP server that maps icon keywords to Remix Icon metadata.","directories":{},"_nodeVersion":"24.10.0","dependencies":{"tsx":"^4.20.6","zod":"^3.25.76","flexsearch":"^0.8.212","@modelcontextprotocol/sdk":"^1.20.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.2.4","typescript":"^5.9.3","@types/node":"^24.7.1","@biomejs/biome":"^2.2.5"},"_npmOperationalInternal":{"tmp":"tmp/remixicon-mcp_1.0.0_1760635266485_0.4885967558756428","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"remixicon-mcp","version":"1.1.0","keywords":["remixicon","mcp","mcp-server","icons","icon-search","keyword-search","model-context-protocol","ai","llm"],"author":{"name":"Frad LEE","email":"fradser@gmail.com"},"license":"MIT","_id":"remixicon-mcp@1.1.0","maintainers":[{"name":"fradser","email":"fradser@gmail.com"}],"homepage":"https://github.com/Remix-Design/RemixIcon-MCP#readme","bugs":{"url":"https://github.com/Remix-Design/RemixIcon-MCP/issues"},"bin":{"remixicon-mcp":"bin/run.cjs"},"dist":{"shasum":"3c39d5c230ed2ff4c270174fa23196ad1195884b","tarball":"https://registry.npmjs.org/remixicon-mcp/-/remixicon-mcp-1.1.0.tgz","fileCount":18,"integrity":"sha512-KpreT3LaqA+AAnRyzoHJPUFOcuix/myUmbzkUWSSGP+nKcZpFvOCorjHxqfCKbJTCkTN2N1ZLsXNmHCW9QRMPA==","signatures":[{"sig":"MEQCIBFIDW+r8zd/+APKyv+IZ79kV8687l0Oyay+YBvHfVNbAiBjkDv6Qd7MZY+84CbQhUU00iUGvAsHf48b7X9Sb6r5hw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":184809},"main":"src/index.ts","engines":{"node":">=18.0.0"},"gitHead":"e6dac201791266bad9db8acbb95d4d45689b2fbb","scripts":{"lint":"biome lint --write","test":"vitest","build":"tsc --noEmit","format":"biome format --write","typecheck":"tsc --noEmit"},"_npmUser":{"name":"fradser","email":"fradser@gmail.com"},"repository":{"url":"git+https://github.com/Remix-Design/RemixIcon-MCP.git","type":"git"},"_npmVersion":"11.7.0","description":"Lightweight MCP server that maps icon keywords to Remix Icon metadata.","directories":{},"_nodeVersion":"24.12.0","dependencies":{"tsx":"^4.20.6","zod":"^3.25.76","flexsearch":"^0.8.212","@modelcontextprotocol/sdk":"^1.20.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.2.4","typescript":"^5.9.3","@types/node":"^24.7.1","@biomejs/biome":"^2.2.5"},"_npmOperationalInternal":{"tmp":"tmp/remixicon-mcp_1.1.0_1767787494818_0.19514354997442207","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"_id":"remixicon-mcp@2.0.0","bin":{"remixicon-mcp":"bin/run.cjs"},"bugs":{"url":"https://github.com/Remix-Design/RemixIcon-MCP/issues"},"dist":{"shasum":"2b5ab040cc76bfbec6f7963cfc11988f0c12dab9","tarball":"https://registry.npmjs.org/remixicon-mcp/-/remixicon-mcp-2.0.0.tgz","fileCount":25,"integrity":"sha512-gGmkwMAyjhXfIfuQqdn4kGmzjCXZDLE6q2mBqNhetnplnaaDJ+qkU6iic7IQVyO4KI4UKgOgWd3pJqV/XlaOHA==","signatures":[{"sig":"MEUCIQCdGriaM1k4u7C4jWIgrRanad79QoVFjuTxtzwy8SA7TQIgOrQJTXShFLWa0j0cctE1glYqN2j3LJwnKkFKofg/DTI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIEGI4BlFljyoWHjoTC+G/ln2q8leHVBzNt8uFM2gq43EAiAQOXixsLbz5kVA8TjpoE+u+6xB4mUr6QJax+HY5q/8Qg=="}],"unpackedSize":231940},"main":"src/index.ts","name":"remixicon-mcp","author":"Frad LEE <fradser@gmail.com>","engines":{"node":">=20.0.0"},"license":"MIT","scripts":{"dev":"wrangler dev","lint":"biome lint --write","test":"vitest run","build":"pnpm typecheck","start":"tsx src/index.ts","deploy":"wrangler deploy","format":"biome format --write","test:e2e":"vitest run --config tests/e2e/vitest.config.mts","typecheck":"tsc --noEmit && tsc --noEmit -p worker/tsconfig.json","start:http":"tsx src/index.ts --transport http","test:watch":"vitest","test:e2e:docker":"bash tests/e2e/run-docker.sh"},"version":"2.0.0","_npmUser":{"name":"fradser","email":"fradser@gmail.com"},"homepage":"https://github.com/Remix-Design/RemixIcon-MCP#readme","keywords":["remixicon","mcp","mcp-server","icons","icon-search","keyword-search","model-context-protocol","ai","llm"],"repository":{"url":"git+https://github.com/Remix-Design/RemixIcon-MCP.git","type":"git"},"description":"Lightweight MCP server that maps icon keywords to Remix Icon metadata.","directories":{},"maintainers":[{"name":"fradser","email":"fradser@gmail.com"}],"dependencies":{"tsx":"^4.23.9","zod":"^4.6.7","flexsearch":"^0.8.212","@hono/node-server":"^2.1.5","@modelcontextprotocol/server":"2.3.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.12","wrangler":"^4.154.0","typescript":"^7.0.2","@types/node":"^26.1.2","@biomejs/biome":"^2.5.7","@cloudflare/workers-types":"^5.20261027.1","@modelcontextprotocol/client":"2.3.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/remixicon-mcp_2.0.0_1793198222689_0.6699320318897639"}}},"time":{"created":"2025-10-16T17:21:06.484Z","modified":"2026-10-28T14:37:03.447Z","1.0.0":"2025-10-16T17:21:06.689Z","1.1.0":"2026-01-07T12:04:54.951Z","2.0.0":"2026-10-28T14:37:02.780Z"},"bugs":{"url":"https://github.com/Remix-Design/RemixIcon-MCP/issues"},"author":"Frad LEE <fradser@gmail.com>","license":"MIT","homepage":"https://github.com/Remix-Design/RemixIcon-MCP#readme","keywords":["remixicon","mcp","mcp-server","icons","icon-search","keyword-search","model-context-protocol","ai","llm"],"repository":{"url":"git+https://github.com/Remix-Design/RemixIcon-MCP.git","type":"git"},"description":"Lightweight MCP server that maps icon keywords to Remix Icon metadata.","maintainers":[{"name":"fradser","email":"fradser@gmail.com"}],"readme":"# RemixIcon MCP ![](https://img.shields.io/npm/v/remixicon-mcp)\n\n[![npm downloads](https://img.shields.io/npm/dt/remixicon-mcp)](https://www.npmjs.com/package/remixicon-mcp) [![License: MIT](https://img.shields.io/npm/l/remixicon-mcp)](https://opensource.org/licenses/MIT)\n\n**English** | [简体中文](README.zh-CN.md)\n\nA Model Context Protocol (MCP) server that maps short keywords to Remix Icon names. Search with up to 20 comma-separated keywords and receive up to 5 ranked matches.\n\n## Features\n\n- Local stdio, local Node.js Streamable HTTP, and Cloudflare Workers HTTP share one MCP SDK v2 server and search implementation.\n- Uses a bundled FlexSearch index with English and Chinese icon tags; no external API or credentials are needed for search.\n- Returns readable text and structured results with names, scores, categories, styles, and matched keywords.\n- Scores all matching candidates before selecting the top results.\n- HTTP supports current MCP and legacy 2025 Streamable HTTP clients. Modern requests receive JSON responses; legacy requests use request-scoped SSE. There is no standalone SSE endpoint or persistent session.\n\n## 2.0.0 migration\n\nVersion 2.0.0 requires Node.js 20 or later for the installed CLI. The complete source-development and test workflow requires Node.js 22.12 or later; Wrangler deployment tooling requires Node.js 22 or later.\n\n- Keep existing stdio client configurations; stdio remains the default. HTTP is opt-in through `--transport http` or a configured MCP URL.\n- Keep reading `matches[].name`. Structured results also include scores, categories, styles, and matched keywords.\n- The server uses MCP SDK v2. HTTP supports modern and legacy Streamable HTTP negotiation, but not the old standalone `/sse` transport or persistent sessions.\n- Worker deployment is separate from npm publication. The existing hosted endpoint continues to report 1.2.0 until separately deployed.\n\nSee [CHANGELOG.md](CHANGELOG.md) for changes.\n\n## Quick start from source\n\nUse Node.js 22.12 or later and pnpm for the complete source-development and test workflow. Wrangler itself requires Node.js 22 or later. The installed CLI runtime supports Node.js 20 or later.\n\n```bash\npnpm install\n\n# Start an HTTP server at http://127.0.0.1:3000/mcp\npnpm start:http\n```\n\nKeep the server running, then configure a URL-capable MCP client with `http://127.0.0.1:3000/mcp`. For Claude Code:\n\n```bash\nclaude mcp add --transport http remix-icon http://127.0.0.1:3000/mcp\n```\n\nTo use stdio instead:\n\n```bash\npnpm start\n```\n\n### CLI and configuration\n\nWith the CLI installed, stdio remains the default:\n\n```bash\nremixicon-mcp\nremixicon-mcp --transport http --host 127.0.0.1 --port 3000\n```\n\nThe same options work when running this checkout directly:\n\n```bash\npnpm exec tsx src/index.ts --transport http --host 127.0.0.1 --port 3000\n```\n\n| CLI option | Environment variable | Default |\n| --- | --- | --- |\n| `--transport` | `MCP_TRANSPORT` | `stdio` |\n| `--host` | `MCP_HOST` | `127.0.0.1` |\n| `--port` | `MCP_PORT` | `3000` |\n\nCLI options override environment variables. For Node HTTP, `MCP_ALLOWED_ORIGINS` optionally accepts comma-separated exact browser origins, such as `https://icons.example.com,http://localhost:5173`. Origins include the scheme and optional port, without a path or trailing slash. Same-origin requests and native clients without an `Origin` header are accepted by default; other browser origins are rejected.\n\nThe default host accepts local connections. To accept connections from other machines, explicitly set `--host 0.0.0.0`. This is public icon search with no authentication. If you expose it externally, configure TLS and any required access controls through your reverse proxy.\n\n### HTTP endpoints\n\n| Endpoint | Methods | Behavior |\n| --- | --- | --- |\n| `/mcp` | `POST`, `OPTIONS` | MCP requests and browser preflight |\n| `/health` | `GET` | JSON health response |\n\n`POST /mcp` requires `Content-Type: application/json`; request bodies are limited to 16 KiB. `GET /mcp` and `DELETE /mcp` return `405`. There is no legacy `/sse` endpoint or persistent session requirement.\n\n### Published stdio package\n\nThe published package can be used by stdio clients:\n\n```bash\nnpx -y remixicon-mcp\n```\n\nFor Claude Desktop, add this entry to `claude_desktop_config.json` and restart the app:\n\n```json\n{\n  \"mcpServers\": {\n    \"remix-icon\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"remixicon-mcp\"]\n    }\n  }\n}\n```\n\nFor Claude Code:\n\n```bash\nclaude mcp add --transport stdio remixicon -- npx -y remixicon-mcp\n```\n\n### Cloudflare Workers\n\nThe existing hosted endpoint is [RemixIcon MCP](https://remix-icon-mcp.frad.workers.dev/mcp). Configure a URL-capable MCP client with that address, or use:\n\n```bash\nclaude mcp add --transport http remix-icon https://remix-icon-mcp.frad.workers.dev/mcp\n```\n\nThe HTTP implementation was deployed and verified on October 24, 2026, with Cloudflare version `1a2ca18e-d7a6-4910-ac2f-c6d318aa407e` serving 100% of traffic. Real MCP clients passed modern (`2026-07-28`) and legacy (`2025-11-25`) protocol negotiation, tool discovery, search, and concurrent calls. The reported server version is `1.2.0`; the deployed MCP SDK is `2.3.0`. This records the previous deployment; it is not updated automatically when release source changes.\n\nUse the endpoint in an MCP client. Opening `/mcp` in a browser sends `GET` and returns `405` as expected; use [/health](https://remix-icon-mcp.frad.workers.dev/health) for a browser health check. Future local edits do not update the hosted service until deployment:\n\n```bash\npnpm dev       # Local Worker preview\npnpm run deploy # Publish to Cloudflare Workers\n```\n\n## Tool: `search_icons`\n\nInput: `keywords`, a nonempty string of up to 200 characters containing up to 20 comma-separated keywords. Use short keywords rather than sentences.\n\n```json\n{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 1,\n  \"method\": \"tools/call\",\n  \"params\": {\n    \"name\": \"search_icons\",\n    \"arguments\": { \"keywords\": \"layout, grid, design\" }\n  }\n}\n```\n\nSuccessful responses include readable `content` and `structuredContent`. The output schema is shared by all transports:\n\n```typescript\n{\n  guidance: string;\n  matches: Array<{\n    name: string;\n    score: number;\n    category: string;\n    style: string;\n    matchedKeywords: string[];\n  }>;\n}\n```\n\n`matches` contains zero to five items. `matches[].name` remains available to existing clients; the additional fields describe ranking and matched catalog tokens. Invalid keyword input returns a tool error. Tool annotations mark the search as read-only and idempotent.\n\n## Project structure\n\n```text\nbin/run.cjs                    CLI launcher\nsrc/cli/                       CLI options and process lifecycle\nsrc/bootstrap/                 Dependency wiring and shared search index\nsrc/domain/                    Icon entities and keyword parser\nsrc/application/               Search use case and repository port\nsrc/infrastructure/            FlexSearch repository and data adapter\nsrc/interface/mcp/             Shared SDK v2 tool registration\nsrc/interface/http/            Shared HTTP routes and request checks\nsrc/data/tags.json             Bundled Remix Icon metadata\nworker/src/index.ts            Cloudflare HTTP entry point\nwrangler.jsonc                 Cloudflare configuration\ntests/                         Unit, transport, and integration tests\n```\n\n## Development\n\n```bash\npnpm start        # Node stdio server\npnpm start:http   # Node HTTP server\npnpm typecheck    # Node and Worker TypeScript checks\npnpm test         # Run unit and local integration suites once\npnpm test:watch   # Watch tests during development\npnpm run test:e2e:docker # Check the hosted HTTP MCP from Docker\npnpm lint         # Biome lint with auto-fix\npnpm format       # Biome formatting\npnpm build        # Build validation\n```\n\nThe Docker command runs nine HTTP MCP cases against `https://remix-icon-mcp.frad.workers.dev/mcp` using a Linux client: modern and legacy negotiation, discovery, searches, no matches, invalid input recovery, concurrent requests, client isolation, and HTTP guards. Set `MCP_E2E_URL` to test another deployment. It uses locked dependencies, copies no host credentials or modules, and removes its test container after the run. Each run saves `report.json` and `runtime.json` in a separate directory under `.e2e/docker-http/`. These live checks are separate from `pnpm test`.\n\n`src/data/tags.json` is bundled metadata from the [official RemixIcon catalog](https://github.com/Remix-Design/RemixIcon/blob/master/tags.json). To refresh it, update the file from that source, run tests and type checks, and review the changes before publishing a package or deploying a Worker. The server treats this metadata as read-only at runtime.\n\n## License\n\n[MIT](LICENSE)\n","readmeFilename":""}