{"_id":"@efolusi/meridian-mcp","_rev":"4-77a894150cce36d7f1c14ee64a71c4ba","name":"@efolusi/meridian-mcp","dist-tags":{"latest":"0.1.3"},"versions":{"0.1.0":{"name":"@efolusi/meridian-mcp","version":"0.1.0","keywords":["mcp","meridian","design-system","efolusi"],"license":"MIT","_id":"@efolusi/meridian-mcp@0.1.0","maintainers":[{"name":"efolusi","email":"admin@efolusi.com"}],"bin":{"meridian-mcp":"server.mjs"},"dist":{"shasum":"1ae3af14497289bc21e03809f8b1a8913a1fd903","tarball":"https://registry.npmjs.org/@efolusi/meridian-mcp/-/meridian-mcp-0.1.0.tgz","fileCount":3,"integrity":"sha512-BmNCTWJRsAhtBIKmy/U8c/z5fLVPrdpW/2hD/KxA5tcgdiVuvEYzWnRD7qD7zt7l3OOLlZtqNrvow7j+EslmNA==","signatures":[{"sig":"MEUCIQDlooM3ZT0Ihkg1YzUnKa8oSLEAUFyNKWPITzP5ZT49HAIgHOueZWBtHHjiu45C6o6/Pqrdty4IfZizlvfEvqnpf3U=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":8071},"type":"module","gitHead":"95f3479a74d7c734d1dfa6d14e784e697c4974d8","_npmUser":{"name":"efolusi","email":"admin@efolusi.com"},"_npmVersion":"11.16.0","description":"MCP server exposing the Meridian design system registry (components, source, types, usage guides, tokens) to AI coding agents.","directories":{},"_nodeVersion":"26.3.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/meridian-mcp_0.1.0_1785322498148_0.20432166594994738","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@efolusi/meridian-mcp","version":"0.1.1","keywords":["mcp","meridian","design-system","efolusi"],"license":"MIT","_id":"@efolusi/meridian-mcp@0.1.1","maintainers":[{"name":"efolusi","email":"admin@efolusi.com"}],"homepage":"https://meridian.efolusi.com","bugs":{"url":"https://github.com/efolusi/meridian/issues"},"bin":{"meridian-mcp":"server.mjs"},"dist":{"shasum":"592937acd0ffcdb9ab09f2cf79ebad2e2940b062","tarball":"https://registry.npmjs.org/@efolusi/meridian-mcp/-/meridian-mcp-0.1.1.tgz","fileCount":3,"integrity":"sha512-7zozE4+mg8JLt7eT4yz+HkLRV6MUSmOibeTDLexwo4ENNnOAd3mCyDUl1u2s2yZODDL6qtb7g4zSP1pkTUAHtg==","signatures":[{"sig":"MEQCIBRPhNywygGSjUYw1nOH2f0cGvWnv71SA3ipQ01X+Vx6AiAH3Xh4TfCgiSY87cJLATC+u0+9Y77iqcoH2oynTpw3Hg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@efolusi%2fmeridian-mcp@0.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":8282},"type":"module","gitHead":"e975d2ee49983c5f0d604c26fb5315cd238d367f","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:459223e5-4916-46d6-ba30-c9ad2bdf4f9c"}},"repository":{"url":"git+https://github.com/efolusi/meridian.git","type":"git","directory":"mcp"},"_npmVersion":"12.0.1","description":"MCP server exposing the Meridian design system registry (components, source, types, usage guides, tokens) to AI coding agents.","directories":{},"_nodeVersion":"22.23.1","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/meridian-mcp_0.1.1_1785323664057_0.3719484349971902","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@efolusi/meridian-mcp","version":"0.1.2","keywords":["mcp","meridian","design-system","efolusi"],"license":"MIT","_id":"@efolusi/meridian-mcp@0.1.2","maintainers":[{"name":"efolusi","email":"admin@efolusi.com"}],"homepage":"https://meridian.efolusi.com","bugs":{"url":"https://github.com/efolusi/meridian/issues"},"bin":{"meridian-mcp":"server.mjs"},"dist":{"shasum":"4f4fa8a4922a664326142a7da56c14e97f0111dd","tarball":"https://registry.npmjs.org/@efolusi/meridian-mcp/-/meridian-mcp-0.1.2.tgz","fileCount":3,"integrity":"sha512-Y2ovzu8hSs+BIJeOKR8R2ApmKgSrMcG7jOWf8NOkWFx+d9fH2PDbqJ9tum+JbazAMsyJ1TJwNIGW6YcWXxiwDQ==","signatures":[{"sig":"MEQCID0DHmvIXdko5UJJl/xiP9/s730pLnQdldJEpeRnTjVBAiAms3z7OP/bJNYt25fHnGLlreyP4WiFWXy85WKJA2ajuQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@efolusi%2fmeridian-mcp@0.1.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":8282},"type":"module","gitHead":"98059176b3db1bc4d2af2b3b88e2423e35b57201","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:459223e5-4916-46d6-ba30-c9ad2bdf4f9c"}},"repository":{"url":"git+https://github.com/efolusi/meridian.git","type":"git","directory":"mcp"},"_npmVersion":"12.0.1","description":"MCP server exposing the Meridian design system registry (components, source, types, usage guides, tokens) to AI coding agents.","directories":{},"_nodeVersion":"22.23.1","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/meridian-mcp_0.1.2_1785323863480_0.832159031474724","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@efolusi/meridian-mcp","version":"0.1.3","description":"MCP server exposing the Meridian design system registry (components, source, types, usage guides, tokens) to AI coding agents.","license":"MIT","homepage":"https://meridian.efolusi.com","repository":{"type":"git","url":"git+https://github.com/efolusi/meridian.git","directory":"mcp"},"type":"module","bin":{"meridian-mcp":"server.mjs"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"keywords":["mcp","meridian","design-system","efolusi"],"gitHead":"ea7ad842391b52ecf770d10477bc80629c507049","_id":"@efolusi/meridian-mcp@0.1.3","bugs":{"url":"https://github.com/efolusi/meridian/issues"},"_nodeVersion":"22.23.2","_npmVersion":"12.0.2","dist":{"integrity":"sha512-CLWoioAEfBkhUb73hgJOg6CMGN8ma5/6t9mmNIvFCJiDft5IVC4HvVdk9y5ThsGx7Hlqbmsg7/Ndl40tbiPoug==","shasum":"f258b871668dfa97662139be91f229a9d3e8c3b1","tarball":"https://registry.npmjs.org/@efolusi/meridian-mcp/-/meridian-mcp-0.1.3.tgz","fileCount":3,"unpackedSize":8296,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@efolusi%2fmeridian-mcp@0.1.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIA6z3g5VEwD9A1lFZgiHbdl+GpPAXFFvkbm0wis8Up/QAiEApBNvoDofkRRqqIyGCXeoBld+73HjzzcHTyRKDMbb1nE="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:459223e5-4916-46d6-ba30-c9ad2bdf4f9c"}},"directories":{},"maintainers":[{"name":"efolusi","email":"admin@efolusi.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/meridian-mcp_0.1.3_1786654409074_0.33120269754467935"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-29T10:54:57.970Z","modified":"2026-08-13T20:53:29.529Z","0.1.0":"2026-07-29T10:54:58.309Z","0.1.1":"2026-07-29T11:14:24.224Z","0.1.2":"2026-07-29T11:17:43.634Z","0.1.3":"2026-08-13T20:53:29.205Z"},"bugs":{"url":"https://github.com/efolusi/meridian/issues"},"license":"MIT","homepage":"https://meridian.efolusi.com","keywords":["mcp","meridian","design-system","efolusi"],"repository":{"type":"git","url":"git+https://github.com/efolusi/meridian.git","directory":"mcp"},"description":"MCP server exposing the Meridian design system registry (components, source, types, usage guides, tokens) to AI coding agents.","maintainers":[{"name":"efolusi","email":"admin@efolusi.com"}],"readme":"# @efolusi/meridian-mcp\n\nAn [MCP](https://modelcontextprotocol.io) server that gives an AI coding agent\nfirst-hand knowledge of the Meridian design system, so it builds correct Meridian\nUI instead of guessing. It exposes the same generated registry the docs site uses.\n\n## Tools\n\n| Tool | What it returns |\n|---|---|\n| `list_components` | Every UI component with a one-line description and categories. Optional `category` filter. |\n| `get_component` | One component's full detail: description, Meridian dependencies, and each file's real content — the `.jsx` source, the `.d.ts` types, and the `.prompt.md` usage guide. |\n| `search_components` | Components matching a keyword across name, title, description and category. |\n| `get_tokens` | Design tokens (colour, typography, spacing, effects) in light, dark and compact. Optional `group` filter. |\n\n## Data source\n\nNo repository needed. By default the server reads the **hosted** registry, so it\nworks standalone:\n\n- `MERIDIAN_SOURCE=https://meridian.efolusi.com` — the default.\n- `MERIDIAN_SOURCE=/path/to/meridian` — a local checkout or a vendored copy, if\n  you prefer offline / pinned data.\n\n## Add it to your agent\n\nIt speaks stdio. Point your agent's MCP config at the command. Once published you\ncan use `npx`; from a checkout use `node /path/to/meridian/mcp/server.mjs`.\n\n**Claude Code**\n\n```bash\nclaude mcp add meridian -- npx -y @efolusi/meridian-mcp\n```\n\n**Claude Desktop / Cursor / any stdio MCP client** (`mcpServers` config):\n\n```json\n{\n  \"mcpServers\": {\n    \"meridian\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@efolusi/meridian-mcp\"],\n      \"env\": { \"MERIDIAN_SOURCE\": \"https://meridian.efolusi.com\" }\n    }\n  }\n}\n```\n\nThen ask your agent things like *\"list Meridian form components\"*, *\"show me the\nCalendar props and date-picker composition\"*, or *\"build an Efolusi settings page with Meridian\"* —\nit will pull the real source and tokens before writing code.\n\n## Run locally / develop\n\n```bash\ncd mcp\nnpm install\nMERIDIAN_SOURCE=.. node server.mjs   # read the local registry\nnode smoke.mjs                        # quick end-to-end check of every tool\n```\n\nMIT licensed.\n","readmeFilename":"README.md"}