{"_id":"@app-cn/mcp","_rev":"3-2ba6790dd8ac87784fa291dd826e7dc8","name":"@app-cn/mcp","dist-tags":{"latest":"0.1.2"},"versions":{"0.1.0":{"name":"@app-cn/mcp","version":"0.1.0","keywords":["react-native","expo","nativewind","shadcn","mcp","model-context-protocol","ai","appcn"],"author":{"name":"Salah-XD"},"license":"MIT","_id":"@app-cn/mcp@0.1.0","maintainers":[{"name":"salah-xd","email":"thisissalah.dev@gmail.com"}],"homepage":"https://appcn.vercel.app","bugs":{"url":"https://github.com/Salah-XD/appCN/issues"},"bin":{"appcn-mcp":"dist/index.js"},"dist":{"shasum":"6e98ddf4579676e07cabc5d261b67925cced834d","tarball":"https://registry.npmjs.org/@app-cn/mcp/-/mcp-0.1.0.tgz","fileCount":4,"integrity":"sha512-Dxh6ib4pePhOwjzvWE1jbdSek6cRX4YPU/yTxSAX50Sk1TE2Twk7lB2AvD8X5Mz/wG1czgtz+NTjeWbhwDFYYQ==","signatures":[{"sig":"MEUCIQCY4/2EmMJXxSvMLZTfcXC6tYJantD66GdU/K1tKG6/hgIgCKpsfbk6ZZqtgsj2R6xW/lODrlrVrYScMIGKzI4CWDk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":16134},"main":"./dist/index.js","type":"module","_from":"file:app-cn-mcp-0.1.0.tgz","engines":{"node":">=20"},"scripts":{"dev":"tsup --watch","build":"tsup","typecheck":"tsc --noEmit"},"_npmUser":{"name":"salah-xd","email":"thisissalah.dev@gmail.com"},"_resolved":"/tmp/8a4395de366397f43cadcdee720fef27/app-cn-mcp-0.1.0.tgz","_integrity":"sha512-Dxh6ib4pePhOwjzvWE1jbdSek6cRX4YPU/yTxSAX50Sk1TE2Twk7lB2AvD8X5Mz/wG1czgtz+NTjeWbhwDFYYQ==","repository":{"url":"git+https://github.com/Salah-XD/appCN.git","type":"git","directory":"packages/mcp"},"_npmVersion":"10.8.2","description":"Model Context Protocol server for appCN. Lets AI coding agents discover, install, and correctly use appCN React Native components.","directories":{},"_nodeVersion":"20.20.2","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.5","typescript":"^5.7.3","@types/node":"^20.17.10","@app-cn/tsconfig":"0.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.0_1780055206026_0.058693680674849036","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@app-cn/mcp","version":"0.1.1","keywords":["react-native","expo","nativewind","shadcn","mcp","model-context-protocol","ai","appcn"],"author":{"name":"Salah-XD"},"license":"MIT","_id":"@app-cn/mcp@0.1.1","maintainers":[{"name":"salah-xd","email":"thisissalah.dev@gmail.com"}],"homepage":"https://appcn.vercel.app","bugs":{"url":"https://github.com/Salah-XD/appCN/issues"},"bin":{"appcn-mcp":"dist/index.js"},"dist":{"shasum":"38a402dd13e3a3c6189a57fac10a18ef0bfd8c28","tarball":"https://registry.npmjs.org/@app-cn/mcp/-/mcp-0.1.1.tgz","fileCount":4,"integrity":"sha512-okIqy7j+XNa9bmehPmhi9x19rhs+aFfidIbAnaWBqN67RbsFJHWVqsvp9W0rVuRiXr3BanhvdXHl6eU3VfVVig==","signatures":[{"sig":"MEYCIQC7XQGYjHcjKrnRP5gkrNituXs8JgjTZZ1EsMtOwSGbPwIhANoJ0dF1SK3wtYTTme4L1dI7/fAabxk4MHz60TMgO7Ol","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":16172},"main":"./dist/index.js","type":"module","_from":"file:app-cn-mcp-0.1.1.tgz","engines":{"node":">=20"},"mcpName":"digital.shineup/appcn","scripts":{"dev":"tsup --watch","build":"tsup","typecheck":"tsc --noEmit"},"_npmUser":{"name":"salah-xd","email":"thisissalah.dev@gmail.com"},"_resolved":"/tmp/0f793c1173156ab48ba18601df04ba75/app-cn-mcp-0.1.1.tgz","_integrity":"sha512-okIqy7j+XNa9bmehPmhi9x19rhs+aFfidIbAnaWBqN67RbsFJHWVqsvp9W0rVuRiXr3BanhvdXHl6eU3VfVVig==","repository":{"url":"git+https://github.com/Salah-XD/appCN.git","type":"git","directory":"packages/mcp"},"_npmVersion":"10.8.2","description":"Model Context Protocol server for appCN. Lets AI coding agents discover, install, and correctly use appCN React Native components.","directories":{},"_nodeVersion":"20.20.2","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.5","typescript":"^5.7.3","@types/node":"^20.17.10","@app-cn/tsconfig":"0.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.1_1780070271245_0.23927543311100563","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@app-cn/mcp","version":"0.1.2","description":"Model Context Protocol server for appCN. Lets AI coding agents discover, install, and correctly use appCN React Native components.","mcpName":"digital.shineup/appcn","keywords":["react-native","expo","nativewind","shadcn","mcp","model-context-protocol","ai","appcn"],"author":{"name":"Salah-XD"},"license":"MIT","homepage":"https://appcn.vercel.app","repository":{"type":"git","url":"git+https://github.com/Salah-XD/appCN.git","directory":"packages/mcp"},"bugs":{"url":"https://github.com/Salah-XD/appCN/issues"},"publishConfig":{"access":"public"},"type":"module","main":"./dist/index.js","bin":{"appcn-mcp":"dist/index.js"},"engines":{"node":">=20"},"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","zod":"^3.25.0"},"devDependencies":{"@types/node":"^20.17.10","tsup":"^8.3.5","typescript":"^5.7.3","@app-cn/tsconfig":"0.0.0"},"scripts":{"build":"tsup","dev":"tsup --watch","typecheck":"tsc --noEmit"},"_id":"@app-cn/mcp@0.1.2","_integrity":"sha512-ko85ADMdzHdkftQwoQSkuF2yxM2fLwzBcBJyq7nuKL+LjgMoV+50uBB864s9v125GgtbECfjFo6e5nnQUHJfag==","_resolved":"/tmp/65194f8e6f689b2050e496a10dfe9d76/app-cn-mcp-0.1.2.tgz","_from":"file:app-cn-mcp-0.1.2.tgz","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-ko85ADMdzHdkftQwoQSkuF2yxM2fLwzBcBJyq7nuKL+LjgMoV+50uBB864s9v125GgtbECfjFo6e5nnQUHJfag==","shasum":"8c63a93169814df7585a9af0267b8a337ff27fbd","tarball":"https://registry.npmjs.org/@app-cn/mcp/-/mcp-0.1.2.tgz","fileCount":4,"unpackedSize":16289,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDsQcmNn+5tKGLYGU1tAluSwQ//zgen+eR8739c878r2QIhAKZVMcWH25F6mCnJ2ChaouvWMoQJgZYypPkm4Pjwo7Qq"}]},"_npmUser":{"name":"salah-xd","email":"thisissalah.dev@gmail.com"},"directories":{},"maintainers":[{"name":"salah-xd","email":"thisissalah.dev@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.1.2_1780133239801_0.29964769085053833"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-29T11:46:45.769Z","modified":"2026-05-30T09:27:20.058Z","0.1.0":"2026-05-29T11:46:46.166Z","0.1.1":"2026-05-29T15:57:51.388Z","0.1.2":"2026-05-30T09:27:19.934Z"},"bugs":{"url":"https://github.com/Salah-XD/appCN/issues"},"author":{"name":"Salah-XD"},"license":"MIT","homepage":"https://appcn.vercel.app","keywords":["react-native","expo","nativewind","shadcn","mcp","model-context-protocol","ai","appcn"],"repository":{"type":"git","url":"git+https://github.com/Salah-XD/appCN.git","directory":"packages/mcp"},"description":"Model Context Protocol server for appCN. Lets AI coding agents discover, install, and correctly use appCN React Native components.","maintainers":[{"name":"salah-xd","email":"thisissalah.dev@gmail.com"}],"readme":"# @app-cn/mcp\n\nThe **appCN MCP server** — gives AI coding agents (Claude Code, Cursor, Windsurf,\nCodex, …) first-class access to the [appCN](https://appcn.vercel.app) React Native\ncomponent library. Agents can discover components, read their full docs (anatomy,\nthe delight detail, props, usage examples, a11y notes), get the exact install\ncommand, and learn appCN's motion/haptic design tokens — so the code they write\nmatches the system instead of guessing.\n\nIt reads from the live appCN registry (`https://appcn.vercel.app/r`), so it always\nreflects the latest published components — nothing to update on your side.\n\n## Install\n\n### Claude Code\n\n```bash\nclaude mcp add appcn -- npx -y @app-cn/mcp\n```\n\n### Cursor / Windsurf (`mcp.json`)\n\n```jsonc\n{\n  \"mcpServers\": {\n    \"appcn\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@app-cn/mcp\"]\n    }\n  }\n}\n```\n\n### VS Code (`.vscode/mcp.json`)\n\n```jsonc\n{\n  \"servers\": {\n    \"appcn\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@app-cn/mcp\"]\n    }\n  }\n}\n```\n\n## Tools\n\n| Tool | What it does |\n| :-- | :-- |\n| `list_components` | List every appCN component (optionally filtered to `base` or `ai`), with its one-line delight detail. |\n| `search_components` | Find components by intent — e.g. \"chat input\", \"voice indicator\". |\n| `get_component` | Full payload for one component: docs, source files, npm + registry dependencies, and the install command. |\n| `get_install_command` | The exact command to add a component (appCN CLI, shadcn URL, or namespaced), per package manager. |\n| `get_design_guide` | appCN's taste layer — motion/haptic tokens and the house rules — so generated code feels like appCN. |\n\n## Configuration\n\n| Env var | Default | Purpose |\n| :-- | :-- | :-- |\n| `APPCN_REGISTRY_URL` | `https://appcn.vercel.app/r` | Point the server at a different (e.g. local) registry. |\n\n## How it relates to the shadcn MCP\n\nappCN is a standard shadcn-compatible registry, so shadcn's own MCP can install\nappCN components too (register `\"@app-cn\"` in your `components.json`). What this\nserver adds on top is the appCN-specific knowledge shadcn's generic registry JSON\ndoesn't carry: the delight detail, usage examples, a11y notes, and the motion/haptic\ndesign guide — the things that make agent-authored code feel like appCN.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}