{"_id":"@cyberweb/kinghost-design-system-mcp","_rev":"2-c47c4947b6bad325e88798ed97a236d1","name":"@cyberweb/kinghost-design-system-mcp","dist-tags":{"latest":"1.0.5"},"versions":{"1.0.4":{"name":"@cyberweb/kinghost-design-system-mcp","version":"1.0.4","keywords":["mcp","model-context-protocol","kinghost","design-system","components","ui","design-tokens","dart-doc","flutter","claude","ai"],"author":{"name":"Squad DevCanais - Kinghost","email":"produtos-canais@kinghost.com.br"},"license":"MIT","_id":"@cyberweb/kinghost-design-system-mcp@1.0.4","maintainers":[{"name":"botmarvin","email":"produtos-canais@kinghost.com.br"},{"name":"security-kinghost","email":"security@kinghost.com.br"}],"contributors":[{"url":"https://kinghost.com","name":"Squad DevCanais","email":"produtos-canais@kinghost.com.br"}],"homepage":"https://gitlab-administrativo.kinghost.net/DevCanais/app/design-system","bugs":{"url":"https://gitlab-administrativo.kinghost.net/DevCanais/app/design-system/-/issues"},"bin":{"kinghost-design-system-mcp":"index.js"},"dist":{"shasum":"94e8a446c517f62f68df7dd08814f3589f31cd48","tarball":"https://registry.npmjs.org/@cyberweb/kinghost-design-system-mcp/-/kinghost-design-system-mcp-1.0.4.tgz","fileCount":168,"integrity":"sha512-9Z/FY9jUA+ewx5UG31JgrAnvNSFaB2G+DzZxwed9ppjX9k328TS3MJc9s/vawI1pBXxLtH+vVMWtg/dc4VxIdA==","signatures":[{"sig":"MEQCIDYiCZbGdYxz8xlPeYUILcet5YbOlZVfN1e7692O0wZ/AiA6jyrmxEiWgL/xqJjxy31oREHU49zzmA8kqLTs1RrEYg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1155827},"main":"index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"2f7d3844ba50fe84e510da7906d7771ca5d1eab5","scripts":{"dev":"node --watch index.js","clean":"rm -rf docs/ node_modules/.cache/","setup":"npm install && npm run build:docs","start":"node index.js","build:docs":"cd ../design-system && dart doc && cp -r doc/api/* ../mcp-server/docs/","prepublishOnly":"echo 'Publicando @cyberweb/kinghost-design-system-mcp...' && npm test || echo 'Testes não configurados'","start-with-docs":"./start-docs-server.sh"},"_npmUser":{"name":"botmarvin","email":"produtos-canais@kinghost.com.br"},"repository":{"url":"git@gitlab-administrativo.kinghost.net:DevCanais/app/design-system.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"10.8.2","description":"🎨 Servidor MCP para Design System KingHost - Acesso dinâmico a componentes e tokens via Dart Doc - Desenvolvido pela Squad DevCanais","directories":{},"_nodeVersion":"20.19.4","dependencies":{"zod":"^3.22.0","axios":"^1.6.0","cheerio":"^1.0.0-rc.12","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/kinghost-design-system-mcp_1.0.4_1754334673855_0.829840765999768","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"@cyberweb/kinghost-design-system-mcp","version":"1.0.5","description":"🎨 Servidor MCP para Design System KingHost - Acesso dinâmico a componentes e tokens via Dart Doc - Desenvolvido pela Squad DevCanais","type":"module","main":"index.js","bin":{"kinghost-design-system-mcp":"index.js"},"scripts":{"start":"node index.js","dev":"node --watch index.js","start-with-docs":"./start-docs-server.sh","prepublishOnly":"echo 'Publicando @cyberweb/kinghost-design-system-mcp...' && npm test || echo 'Testes não configurados'","build:docs":"cd ../design-system && dart doc && cp -r doc/api/* ../mcp-server/docs/","clean":"rm -rf docs/ node_modules/.cache/","setup":"npm install && npm run build:docs"},"keywords":["mcp","model-context-protocol","kinghost","design-system","components","ui","design-tokens","dart-doc","flutter","claude","ai"],"author":{"name":"Squad DevCanais - Kinghost","email":"produtos-canais@kinghost.com.br"},"contributors":[{"name":"Squad DevCanais","email":"produtos-canais@kinghost.com.br","url":"https://kinghost.com"}],"license":"MIT","homepage":"https://gitlab-administrativo.kinghost.net/DevCanais/app/design-system","repository":{"type":"git","url":"git@gitlab-administrativo.kinghost.net:DevCanais/app/design-system.git","directory":"packages/mcp-server"},"bugs":{"url":"https://gitlab-administrativo.kinghost.net/DevCanais/app/design-system/-/issues"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","zod":"^3.22.0","axios":"^1.6.0","cheerio":"^1.0.0-rc.12"},"engines":{"node":">=18.0.0"},"_id":"@cyberweb/kinghost-design-system-mcp@1.0.5","gitHead":"638e44957db10db8843551836b00bdf9d69afd3a","_nodeVersion":"20.19.4","_npmVersion":"10.8.2","dist":{"integrity":"sha512-5Sj6kejJPMZMJXgr9tJoz5X+E0V9Cl2iENUn6NgtClFNng2WMSm3rGKPjovOGWctWEIe4LSQ+YsJcHpM8PQNgg==","shasum":"9b75403e9609323a55769f4be00727519151d9a7","tarball":"https://registry.npmjs.org/@cyberweb/kinghost-design-system-mcp/-/kinghost-design-system-mcp-1.0.5.tgz","fileCount":168,"unpackedSize":1184221,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDytsAerQz6gBOcmryek/ia1xvGtXBq1GvF7BLzbpMr6QIgb+3HrWPQ40lLLufHAEoh8F8bbHz81NXg5w2PPaJ5Hdg="}]},"_npmUser":{"name":"botmarvin","email":"produtos-canais@kinghost.com.br"},"directories":{},"maintainers":[{"name":"botmarvin","email":"produtos-canais@kinghost.com.br"},{"name":"security-kinghost","email":"security@kinghost.com.br"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/kinghost-design-system-mcp_1.0.5_1754342033013_0.5742684647019276"},"_hasShrinkwrap":false}},"time":{"created":"2025-08-04T19:11:13.759Z","modified":"2025-08-04T21:13:53.479Z","1.0.4":"2025-08-04T19:11:14.120Z","1.0.5":"2025-08-04T21:13:53.287Z"},"bugs":{"url":"https://gitlab-administrativo.kinghost.net/DevCanais/app/design-system/-/issues"},"author":{"name":"Squad DevCanais - Kinghost","email":"produtos-canais@kinghost.com.br"},"license":"MIT","homepage":"https://gitlab-administrativo.kinghost.net/DevCanais/app/design-system","keywords":["mcp","model-context-protocol","kinghost","design-system","components","ui","design-tokens","dart-doc","flutter","claude","ai"],"repository":{"type":"git","url":"git@gitlab-administrativo.kinghost.net:DevCanais/app/design-system.git","directory":"packages/mcp-server"},"description":"🎨 Servidor MCP para Design System KingHost - Acesso dinâmico a componentes e tokens via Dart Doc - Desenvolvido pela Squad DevCanais","contributors":[{"name":"Squad DevCanais","email":"produtos-canais@kinghost.com.br","url":"https://kinghost.com"}],"maintainers":[{"name":"botmarvin","email":"produtos-canais@kinghost.com.br"},{"name":"security-kinghost","email":"security@kinghost.com.br"}],"readme":"# 🎨 Kinghost Widgetbook MCP Server\n\nServidor MCP (Model Context Protocol) para integração com o sistema de design Kinghost via Widgetbook.\n\n**Desenvolvido pela Squad DevCanais - Kinghost**\n\n## 🚀 Instalação e Uso\n\n### Para qualquer desenvolvedor (recomendado):\n\n```bash\nnpx kinghost-widgetbook-mcp\n```\n\n### Instalação global (opcional):\n\n```bash\nnpm install -g kinghost-widgetbook-mcp\nkinghost-widgetbook-mcp\n```\n\n## ⚙️ Configuração no Cursor\n\nAdicione no seu arquivo `mcp.json` (Cursor):\n\n### macOS/Linux:\n```bash\ncode ~/.cursor/mcp.json\n```\n\n### Windows:\n```bash\ncode %APPDATA%/Cursor/mcp.json\n```\n\n### Configuração do arquivo:\n\n```json\n{\n  \"mcpServers\": {\n    \"kinghost-widgetbook\": {\n      \"command\": \"npx\",\n      \"args\": [\"@cyberweb/kinghost-widgetbook-mcp@latest\"],\n      \"env\": {\n        \"WIDGETBOOK_URL\": \"https://widgetbook.kinghost.com\"\n      }\n    }\n  }\n}\n```\n\n## 🛠️ Ferramentas Disponíveis\n\n| Ferramenta | Descrição | Parâmetros |\n|------------|-----------|------------|\n| `listar_componentes` | Lista todos os componentes disponíveis | `categoria` (opcional), `status` (opcional) |\n| `buscar_componente` | Busca detalhes de um componente específico | `nome` (obrigatório) |\n| `buscar_tokens` | Consulta tokens de design (cores, espaçamento, etc.) | `categoria` (opcional) |\n\n## 🔧 Variáveis de Ambiente\n\n| Variável | Descrição | Padrão |\n|----------|-----------|---------|\n| `WIDGETBOOK_URL` | URL base do Widgetbook | `https://widgetbook.kinghost.com` |\n| `WIDGETBOOK_API` | Endpoint da API (se disponível) | - |\n\n## 🏗️ Arquitetura\n\n```\n┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐\n│   Cursor AI     │◄──►│  MCP Server      │◄──►│   Widgetbook    │\n│                 │    │  (Este projeto)  │    │   (Design Sys)  │\n└─────────────────┘    └──────────────────┘    └─────────────────┘\n```\n\n## 🚦 Fluxo de Funcionamento\n\n1. **Cursor AI** faz solicitação via MCP\n2. **MCP Server** processa a solicitação\n3. **Consulta dados** do Widgetbook (mock data por enquanto)\n4. **Retorna informações** formatadas para o Cursor\n\n## 🧪 Teste Rápido\n\nApós configurar no Cursor, teste com:\n\n```\n\"Liste os componentes disponíveis no design system\"\n```\n\n## 📦 Dependências\n\n- **Node.js** >= 18.0.0\n- **@modelcontextprotocol/sdk**: Framework MCP\n- **zod**: Validação de schemas\n\n## 🔍 Troubleshooting\n\n### Cursor não encontra o servidor:\n1. Verifique se o `mcp.json` está no local correto\n2. Reinicie o Cursor\n3. Verifique se Node.js está instalado (`node --version`)\n\n### npx não funciona:\n```bash\n# Limpe o cache do npm\nnpm cache clean --force\n\n# Tente novamente\nnpx kinghost-widgetbook-mcp\n```\n\n### Problemas de permissão:\n```bash\n# No macOS/Linux, pode ser necessário:\nchmod +x $(which npx)\n```\n\n## 📈 Versioning\n\n- **Atual**: v1.0.2\n- **Registro**: npm público\n- **Instalação**: `npx kinghost-widgetbook-mcp`\n\n## 🤝 Contribuindo\n\n1. Fork o projeto\n2. Crie sua feature branch (`git checkout -b feature/nova-funcionalidade`)\n3. Commit suas mudanças (`git commit -am 'Adiciona nova funcionalidade'`)\n4. Push para a branch (`git push origin feature/nova-funcionalidade`)\n5. Abra um Pull Request\n\n## 📞 Suporte\n\n- **Squad DevCanais**: produtos-canais@kinghost.com.br\n- **Repositório**: [GitLab Kinghost](https://gitlab-administrativo.kinghost.net/DevCanais/design-system-app/mcp-app)\n- **Issues**: [Reportar problema](https://gitlab-administrativo.kinghost.net/DevCanais/design-system-app/mcp-app/issues)\n\n## 📜 Licença\n\nMIT © Squad DevCanais - Kinghost\n\n---\n\n**🎯 Objetivo**: Facilitar o acesso aos componentes e tokens do Design System Kinghost através do Cursor AI, permitindo que desenvolvedores consultem informações de forma natural e eficiente. ","readmeFilename":"README.md"}