{"_id":"@agentience/react-design-systems-mcp","_rev":"4-69df26dcf1f54d0f5c56c672cf17393b","name":"@agentience/react-design-systems-mcp","dist-tags":{"latest":"1.0.7"},"versions":{"1.0.0":{"name":"@agentience/react-design-systems-mcp","version":"1.0.0","keywords":["mcp","cloudscape","aws","design-system","components","ui","react","material-ui","chakra-ui","ant-design"],"author":{"name":"IFTI Development Team"},"license":"MIT","_id":"@agentience/react-design-systems-mcp@1.0.0","maintainers":[{"name":"tmolander","email":"troy@agentience.ai"}],"homepage":"https://github.com/agentience/react-design-systems-mcp#readme","bugs":{"url":"https://github.com/agentience/react-design-systems-mcp/issues"},"bin":{"react-design-systems-mcp":"dist/server-fastmcp.js"},"dist":{"shasum":"aa40acc0faf4fc99c65bade4438d443057bb3cc4","tarball":"https://registry.npmjs.org/@agentience/react-design-systems-mcp/-/react-design-systems-mcp-1.0.0.tgz","fileCount":84,"integrity":"sha512-F3s2jKHMJyFbJfKVqc8/txcUkb35UHuH94etIfGYVyxhqSiE1VO1ZlvNe+vYpZ+EGA0JN+TQYaU7rRcJpUA/Pw==","signatures":[{"sig":"MEYCIQC6PXcJgLV5hfO2Zrm9UgKvJdWRWBBkIRktrvescPcaQAIhAOA9HHu5HbTMuFS28CZleqOxJhUcKgTA0enhmUsweFyl","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":466549},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"3883bf49ac5a57dd3d41d117a9225d304f8e7693","scripts":{"dev":"nodemon --exec ts-node server-fastmcp.ts","lint":"eslint .","test":"jest","build":"tsc -p tsconfig.build.json","clean":"rimraf dist","start":"node dist/server-fastmcp.js","dev:sse":"PORT=3005 TRANSPORT_TYPE=sse nodemon --exec ts-node server-fastmcp.ts","prepare":"npm run build","test:ci":"CI=true SKIP_LONG_RUNNING_TESTS=true jest","prebuild":"npm run clean","test:e2e":"jest --selectProjects e2e","test:roo":"jest --testMatch '**/roo-integration.test.ts'","postbuild":"node -e \"require('fs').cpSync('src/components/data', 'dist/components/data', {recursive: true}); require('fs').chmodSync('dist/server-fastmcp.js', '755');\"","test:unit":"jest --selectProjects unit","dev:legacy":"nodemon --exec ts-node server.ts","test:tools":"jest --testMatch '**/tools.test.ts'","prepublishOnly":"npm run test:ci","test:resources":"jest --testMatch '**/resources.test.ts'","test:components":"jest --testMatch '**/component-details.test.ts'"},"_npmUser":{"name":"tmolander","email":"troy@agentience.ai"},"repository":{"url":"git+https://github.com/agentience/react-design-systems-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for React design systems, currently supporting AWS Cloudscape with more to come","directories":{},"_nodeVersion":"18.20.8","dependencies":{"tslib":"2.8.1","lodash":"^4.17.21","express":"^4.18.2","fastmcp":"^1.22.4","js-yaml":"^4.1.0"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","eslint":"^8.56.0","rimraf":"^5.0.5","nodemon":"^3.0.3","ts-jest":"^29.1.2","ts-node":"^10.9.2","babel-jest":"^29.7.0","jest-junit":"^16.0.0","typescript":"^5.3.3","@types/jest":"^29.5.12","@types/node":"^20.11.19","@types/lodash":"^4.14.202","@types/express":"^4.17.21","@types/js-yaml":"^4.0.9","@babel/preset-env":"^7.26.9","@babel/preset-typescript":"^7.27.0"},"_npmOperationalInternal":{"tmp":"tmp/react-design-systems-mcp_1.0.0_1746484555502_0.1537585225532263","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"@agentience/react-design-systems-mcp","version":"1.0.5","keywords":["mcp","cloudscape","aws","design-system","components","ui","react","material-ui","chakra-ui","ant-design"],"author":{"name":"IFTI Development Team"},"license":"MIT","_id":"@agentience/react-design-systems-mcp@1.0.5","maintainers":[{"name":"tmolander","email":"troy@agentience.ai"}],"homepage":"https://github.com/agentience/react-design-systems-mcp#readme","bugs":{"url":"https://github.com/agentience/react-design-systems-mcp/issues"},"bin":{"react-design-systems-mcp":"dist/server.js"},"dist":{"shasum":"11d0abba37c017906817fcb37ca4dbaa38ec69f0","tarball":"https://registry.npmjs.org/@agentience/react-design-systems-mcp/-/react-design-systems-mcp-1.0.5.tgz","fileCount":84,"integrity":"sha512-bWYnukr98g5HmMNmlBmXk7PdHewr/bDx0ODCC2OM5uJiVauvGC77/9kcR/Uq4eojq2eAfN3d20rzuLAG/kXU0w==","signatures":[{"sig":"MEQCIGkC6k7hdRRo9J9meSG2U+N9NpYQP7TU95fxE/x6RjqDAiBho/PIaWoNnDuWZm4TV6RMIp6LgH7S0cB4EIzSbcMXJA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":349989},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=24.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"38ca88a03bd096fcac994309687154d7662d41ba","scripts":{"dev":"nodemon --exec ts-node server.ts","lint":"eslint .","test":"jest","build":"tsc -p tsconfig.build.json","clean":"rimraf dist","start":"node dist/server.js","dev:sse":"PORT=3001 nodemon --exec ts-node server.ts --transport sse","prepare":"npm run build","test:ci":"CI=true SKIP_LONG_RUNNING_TESTS=true jest","prebuild":"npm run clean","test:e2e":"jest --selectProjects e2e","test:roo":"jest --testMatch '**/roo-integration.test.ts'","postbuild":"node -e \"require('fs').cpSync('src/components/data', 'dist/components/data', {recursive: true}); require('fs').chmodSync('dist/server.js', '755');\"","test:unit":"jest --selectProjects unit","test:tools":"jest --testMatch '**/tools.test.ts'","prepublishOnly":"npm run test:ci","test:resources":"jest --testMatch '**/resources.test.ts'","test:components":"jest --testMatch '**/component-details.test.ts'"},"_npmUser":{"name":"tmolander","email":"troy@agentience.ai"},"repository":{"url":"git+https://github.com/agentience/react-design-systems-mcp.git","type":"git"},"_npmVersion":"11.3.0","description":"MCP server for React design systems, currently supporting AWS Cloudscape with more to come","directories":{},"_nodeVersion":"24.0.2","dependencies":{"tslib":"2.8.1","lodash":"^4.17.21","express":"^4.18.2","fastmcp":"^1.22.4","js-yaml":"^4.1.0"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","eslint":"^8.56.0","rimraf":"^5.0.5","nodemon":"^3.0.3","ts-jest":"^29.1.2","ts-node":"^10.9.2","babel-jest":"^29.7.0","jest-junit":"^16.0.0","typescript":"^5.3.3","@types/jest":"^29.5.12","@types/node":"^20.11.19","@types/lodash":"^4.14.202","@types/express":"^4.17.21","@types/js-yaml":"^4.0.9","@babel/preset-env":"^7.26.9","@babel/preset-typescript":"^7.27.0"},"_npmOperationalInternal":{"tmp":"tmp/react-design-systems-mcp_1.0.5_1747519746901_0.826963897881672","host":"s3://npm-registry-packages-npm-production"}},"1.0.6":{"name":"@agentience/react-design-systems-mcp","version":"1.0.6","keywords":["mcp","react","design-system","design-systems","cloudscape","aws","components","ui","material-ui","chakra-ui","ant-design","blueprint","mantine"],"author":{"name":"IFTI Development Team"},"license":"MIT","_id":"@agentience/react-design-systems-mcp@1.0.6","maintainers":[{"name":"tmolander","email":"troy@agentience.ai"}],"homepage":"https://github.com/agentience/react-design-systems-mcp#readme","bugs":{"url":"https://github.com/agentience/react-design-systems-mcp/issues"},"bin":{"react-design-systems-mcp":"dist/server.js"},"dist":{"shasum":"4f0d4866165fb7720a52320b0394f11e6e82a242","tarball":"https://registry.npmjs.org/@agentience/react-design-systems-mcp/-/react-design-systems-mcp-1.0.6.tgz","fileCount":704,"integrity":"sha512-xDypG77hY+U91ZjY2xe+i9mL6Dfsdj2kN18nALfS3pih94MSB7kBZv+REpQoZRRQ4biD/KBs+3wZjJ54lc67mg==","signatures":[{"sig":"MEQCIFFkD/KCSe1gkt+F1RQSVo6x7m31jg5XApP1zof++qtkAiATemUjA7BvM3ZZzo6xoG21kXf7YVstKVXQNSjnPglxFA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2458522},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=24.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"50f49924090057ca0b7f594ba2b79b641c2faa9a","scripts":{"dev":"nodemon --exec ts-node server.ts","lint":"eslint .","test":"jest","build":"npm run clean && npm run prepare && npm run update-links && npm run postbuild","clean":"rimraf dist","start":"node dist/server.js","dev:sse":"PORT=3001 nodemon --exec ts-node server.ts --transport sse","prepare":"tsc -p tsconfig.build.json","test:ci":"CI=true SKIP_LONG_RUNNING_TESTS=true jest","prebuild":"npm run clean","test:e2e":"jest --selectProjects e2e","test:roo":"jest --testMatch '**/roo-integration.test.ts'","postbuild":"node -e \"require('fs').cpSync('src/components/data', 'dist/components/data', {recursive: true}); require('fs').chmodSync('dist/server.js', '755');\"","test:unit":"jest --selectProjects unit","test:tools":"jest --testMatch '**/tools.test.ts'","test:search":"jest --testMatch '**/search-engine.test.ts'","update-links":"python3 scripts/update-markdown-links.py","prepublishOnly":"npm run test:ci","test:resources":"jest --testMatch '**/resources.test.ts'","test:components":"jest --testMatch '**/component-details.test.ts'","update-links:dry-run":"python3 scripts/update-markdown-links.py --dry-run","update-links:verbose":"python3 scripts/update-markdown-links.py --verbose"},"_npmUser":{"name":"tmolander","email":"troy@agentience.ai"},"repository":{"url":"git+https://github.com/agentience/react-design-systems-mcp.git","type":"git"},"_npmVersion":"11.3.0","description":"Model Context Protocol (MCP) server that provides comprehensive information about design systems created for React, currently focusing on AWS Cloudscape Design System","directories":{},"_nodeVersion":"24.1.0","dependencies":{"tslib":"2.8.1","lodash":"^4.17.21","express":"^4.18.2","fastmcp":"^1.22.4","js-yaml":"^4.1.0"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","eslint":"^8.56.0","rimraf":"^5.0.5","nodemon":"^3.0.3","ts-jest":"^29.1.2","ts-node":"^10.9.2","babel-jest":"^29.7.0","jest-junit":"^16.0.0","typescript":"^5.3.3","@types/jest":"^29.5.12","@types/node":"^20.11.19","@types/lodash":"^4.14.202","@types/express":"^4.17.21","@types/js-yaml":"^4.0.9","@babel/preset-env":"^7.26.9","@babel/preset-typescript":"^7.27.0"},"_npmOperationalInternal":{"tmp":"tmp/react-design-systems-mcp_1.0.6_1749164075179_0.6682373260563241","host":"s3://npm-registry-packages-npm-production"}},"1.0.7":{"name":"@agentience/react-design-systems-mcp","version":"1.0.7","description":"Model Context Protocol (MCP) server that provides comprehensive information about design systems created for React, currently focusing on AWS Cloudscape Design System","main":"dist/index.js","bin":{"react-design-systems-mcp":"dist/server.js"},"types":"dist/index.d.ts","exports":{".":{"require":"./dist/index.js","import":"./dist/index.js","types":"./dist/index.d.ts"}},"scripts":{"start":"node dist/server.js","dev":"nodemon --exec ts-node server.ts","dev:sse":"PORT=3001 nodemon --exec ts-node server.ts --transport sse","build":"npm run clean && npm run prepare && npm run update-links && npm run postbuild","prebuild":"npm run clean","postbuild":"node -e \"require('fs').cpSync('src/components/data', 'dist/components/data', {recursive: true}); require('fs').chmodSync('dist/server.js', '755');\"","prepare":"tsc -p tsconfig.build.json","update-links":"python3 scripts/update-markdown-links.py","update-links:dry-run":"python3 scripts/update-markdown-links.py --dry-run","update-links:verbose":"python3 scripts/update-markdown-links.py --verbose","test":"jest","test:unit":"jest --selectProjects unit","test:e2e":"jest --selectProjects e2e","test:tools":"jest --testMatch '**/tools.test.ts'","test:resources":"jest --testMatch '**/resources.test.ts'","test:roo":"jest --testMatch '**/roo-integration.test.ts'","test:components":"jest --testMatch '**/component-details.test.ts'","test:search":"jest --testMatch '**/search-engine.test.ts'","test:ci":"CI=true SKIP_LONG_RUNNING_TESTS=true jest","lint":"eslint .","clean":"rimraf dist","prepublishOnly":"npm run test:ci"},"keywords":["mcp","react","design-system","design-systems","cloudscape","aws","components","ui","material-ui","chakra-ui","ant-design","blueprint","mantine"],"author":{"name":"IFTI Development Team"},"license":"MIT","dependencies":{"express":"^4.18.2","fastmcp":"^1.22.4","js-yaml":"^4.1.0","lodash":"^4.17.21","tslib":"2.8.1"},"devDependencies":{"@babel/preset-env":"^7.26.9","@babel/preset-typescript":"^7.27.0","@types/express":"^4.17.21","@types/jest":"^29.5.12","@types/js-yaml":"^4.0.9","@types/lodash":"^4.14.202","@types/node":"^20.11.19","babel-jest":"^29.7.0","eslint":"^8.56.0","jest":"^29.7.0","jest-junit":"^16.0.0","nodemon":"^3.0.3","rimraf":"^5.0.5","ts-jest":"^29.1.2","ts-node":"^10.9.2","typescript":"^5.3.3"},"engines":{"node":">=24.0.0"},"repository":{"type":"git","url":"git+https://github.com/agentience/react-design-systems-mcp.git"},"bugs":{"url":"https://github.com/agentience/react-design-systems-mcp/issues"},"homepage":"https://github.com/agentience/react-design-systems-mcp#readme","_id":"@agentience/react-design-systems-mcp@1.0.7","gitHead":"d4be33d30a4282163fa5e7fd3418672a5a1fe849","_nodeVersion":"24.1.0","_npmVersion":"11.3.0","dist":{"integrity":"sha512-mfrjXIgtGWBrihcSdtq6NSi+zeaVazlnEE1N588nGb83QD02JGlvHhtiK2KpASxwrqRnmnx2V7DdkgrSSQssGg==","shasum":"4d5a80d1b121a84052a3008901bb88d47cde03e7","tarball":"https://registry.npmjs.org/@agentience/react-design-systems-mcp/-/react-design-systems-mcp-1.0.7.tgz","fileCount":704,"unpackedSize":2457166,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIBfeHsHgrHOZJTNJtldTvY3YlsuSI3ibCjyrFCDVP+3nAiEAgtDZ3mdCdv0N1vJdAModKEvbwiu+I+h94Ht+u5K44CI="}]},"_npmUser":{"name":"tmolander","email":"troy@agentience.ai"},"directories":{},"maintainers":[{"name":"tmolander","email":"troy@agentience.ai"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/react-design-systems-mcp_1.0.7_1749167404148_0.573891779690133"},"_hasShrinkwrap":false}},"time":{"created":"2025-05-05T22:35:55.407Z","modified":"2025-06-05T23:50:04.583Z","1.0.0":"2025-05-05T22:35:55.753Z","1.0.5":"2025-05-17T22:09:07.139Z","1.0.6":"2025-06-05T22:54:35.617Z","1.0.7":"2025-06-05T23:50:04.410Z"},"bugs":{"url":"https://github.com/agentience/react-design-systems-mcp/issues"},"author":{"name":"IFTI Development Team"},"license":"MIT","homepage":"https://github.com/agentience/react-design-systems-mcp#readme","keywords":["mcp","react","design-system","design-systems","cloudscape","aws","components","ui","material-ui","chakra-ui","ant-design","blueprint","mantine"],"repository":{"type":"git","url":"git+https://github.com/agentience/react-design-systems-mcp.git"},"description":"Model Context Protocol (MCP) server that provides comprehensive information about design systems created for React, currently focusing on AWS Cloudscape Design System","maintainers":[{"name":"tmolander","email":"troy@agentience.ai"}],"readme":"# React Design Systems\n\n[![npm version](https://img.shields.io/npm/v/@agentience/react-design-systems-mcp.svg)](https://www.npmjs.com/package/@agentience/react-design-systems-mcp)\n\nReact Design Systems is a Model Context Protocol (MCP) server that provides comprehensive information about design systems created for React. The current version focuses exclusively on the AWS Cloudscape Design System components, along with code generation capabilities. It's built using the FastMCP framework and TypeScript.\n\nFuture versions will expand to support additional popular React design systems including Material UI, Chakra UI, Ant Design, Blueprint, and Mantine.\n\n## Change Log\nSee [CHANGELOG.md]\n\n## Features\n\n### Component Information & Search\n- Search for Cloudscape components with advanced filtering options\n- Get detailed information about components including properties, events, and functions\n- Access component usage guidelines and best practices\n- Search across component usage guidelines by content, section, or specific component\n- Get component examples with detailed code snippets\n- Compare components and their capabilities\n\n### Code Generation\n- Generate code for components with customization options\n- Generate code for common UI patterns and layouts\n- Generate multi-component layouts and compositions\n- Validate component props and configurations\n\n### Advanced Functionality\n- **Usage Guidelines**: Comprehensive access to component usage guidelines with hybrid resource/tool approach\n  - Direct access via `cloudscape://usage/{componentId}` resource URIs\n  - Advanced search capabilities across all usage content\n  - Section-specific filtering (Features, General guidelines, etc.)\n  - Cross-component content search\n- **Events & Functions**: Search and explore component events and function APIs\n- **Pattern Library**: Access to design patterns and architectural guidance\n- **Setup Instructions**: Get frontend-code mode setup and configuration guidance\n\n## Requirements\n\n- **Node.js**: 24.0.1 or higher\n- **npm**: 10.x or higher (comes with Node.js 24.0.1)\n\n## Installation\n\n### For Usage as a Dependency\n\n```bash\n# Install from npm\nnpm install @agentience/react-design-systems-mcp\n```\n\n### Global Installation\n\n```bash\n# Install globally to use as a CLI tool\nnpm install -g @agentience/react-design-systems-mcp\n\n# Then you can run it directly\nreact-design-systems-mcp\n```\n\n## Claude Desktop Configuration\n\nTo use React Design Systems with Claude Desktop, you can configure it as an MCP server using the npm package. This allows Claude Desktop to automatically launch the server when needed.\n\n### Configuration File\n\nAdd the following configuration to your Claude Desktop MCP settings file:\n\n**Location:**\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n**Configuration:**\n```json\n{\n  \"mcpServers\": {\n    \"react-design-systems\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"@agentience/react-design-systems-mcp\"\n      ]\n    }\n  }\n}\n```\n\n### Command Line Parameters\n\nThe server supports the following command line parameters:\n\n- `--transport <type>` or `-t <type>`: Transport type (`stdio` or `sse`). Default: `stdio`\n- `--port <number>` or `-p <number>`: Port for SSE transport. Default: `3001`\n- `--bind <address>` or `-b <address>`: Bind address for SSE transport. Default: `0.0.0.0`\n\n### Advanced Configuration Examples\n\n#### With Custom Parameters\n\n```json\n{\n  \"mcpServers\": {\n    \"react-design-systems\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"@agentience/react-design-systems-mcp\",\n        \"--transport\",\n        \"stdio\"\n      ]\n    }\n  }\n}\n```\n\n#### Using Local Installation\n\nIf you have the package installed globally or locally:\n\n```json\n{\n  \"mcpServers\": {\n    \"react-design-systems\": {\n      \"command\": \"react-design-systems-mcp\"\n    }\n  }\n}\n```\n\n#### Development Configuration\n\nFor development with a local build:\n\n```json\n{\n  \"mcpServers\": {\n    \"react-design-systems\": {\n      \"command\": \"node\",\n      \"args\": [\n        \"/path/to/react-design-systems-mcp/dist/server.js\"\n      ],\n      \"cwd\": \"/path/to/react-design-systems-mcp\"\n    }\n  }\n}\n```\n\n### Verification\n\nAfter adding the configuration:\n\n1. Restart Claude Desktop\n2. Start a new conversation\n3. The React Design Systems MCP server should be automatically available\n4. You can use tools like `search_components` to verify the connection\n\nFor troubleshooting connection issues, see the [MCP Protocol Guide](docs/mcp-protocol-guide.md).\n\n## Docker Deployment\n\nThis project can be deployed using Docker. For detailed instructions, see [Docker Deployment Guide](DOCKER.md).\n\n### Quick Start with Docker\n\n```bash\n# Pull the image from GitHub Container Registry\ndocker pull ghcr.io/agentience/react-design-systems-mcp:latest\n\n# Run the container\ndocker run -d -p 3005:3005 --name react-design-systems-mcp ghcr.io/agentience/react-design-systems-mcp:latest\n```\n\n### Using Docker Compose\n\n```bash\n# Clone the repository\ngit clone https://github.com/agentience/react-design-systems-mcp.git\ncd react-design-systems-mcp\n\n# Start with Docker Compose\ndocker-compose up -d\n```\n\nFor information on building and publishing the Docker image to GitHub Container Registry, see [Docker Publishing Guide](docs/docker-publishing-guide.md).\n\n## FastMCP Implementation\n\nThis project uses the FastMCP framework for a more structured and type-safe approach to building MCP servers. For detailed information about the FastMCP implementation and development setup, see [DEVELOPMENT.md](DEVELOPMENT.md).\n\n## Available Tools and Resources\n\n### MCP Tools\n\n#### Component Information\n- `search_components` - Search for components with advanced filtering\n- `get_component_details` - Get detailed component information\n- `get_component_properties` - Get component properties and their specifications\n- `get_component_events` - Get component events and event handling information\n- `get_component_functions` - Get component functions and method APIs\n- `get_component_examples` - Get component examples with optional filtering by example ID\n\n#### Usage Guidelines\n- `get_component_usage` - Get usage guidelines for a specific component with optional section filtering\n- `search_usage_guidelines` - Search across component usage guidelines with query, section, and component filters\n\n#### Code Generation\n- `generate_component_code` - Generate code for components with customization\n- `generate_pattern_code` - Generate code for common UI patterns\n- `validate_component_props` - Validate component properties and configurations\n\n#### Patterns and Search\n- `search_patterns` - Search through design patterns and architectural guidance\n- `search_properties` - Search for component properties across all components\n- `search_events` - Search for component events with filtering options\n- `search_functions` - Search for component functions and methods\n\n#### Utility Tools\n- `compare_components` - Compare multiple components and their capabilities\n- `generate_layout_code` - Generate multi-component layouts\n- `get_frontend_setup` - Get setup instructions for frontend-code mode\n- `get_link_resource` - Resolve internal links from usage.md files to appropriate backend resources\n\n### MCP Resources\n\n#### Component Usage Guidelines\n- `cloudscape://usage/{componentId}` - Direct access to component usage guidelines in markdown format\n\n### Example Usage\n\n```bash\n# Search for button-related components\nsearch_components({\"query\": \"button\", \"category\": \"actions\"})\n\n# Get detailed information about a specific component\nget_component_details({\"componentId\": \"button\"})\n\n# Access usage guidelines directly\nResource: cloudscape://usage/button\n\n# Search across usage guidelines\nsearch_usage_guidelines({\"query\": \"primary button\", \"section\": \"Features\"})\n\n# Generate component code\ngenerate_component_code({\"componentId\": \"button\", \"variant\": \"primary\"})\n```\n\n## Documentation\n\n- [Architecture](docs/architecture.md)\n- [Component Library](docs/component-library.md)\n- [FastMCP Implementation](docs/fastmcp-implementation.md)\n- [Frontend Code Mode](docs/frontend-code-mode.md)\n- [MCP Protocol Guide](docs/mcp-protocol-guide.md)\n- [Roo Integration Guide](docs/roo-integration-guide.md)\n- [Usage Guide](docs/usage-guide.md)\n- [Docker Deployment Guide](DOCKER.md)\n- [Docker Publishing Guide](docs/docker-publishing-guide.md)\n\n## Roadmap\n\nReact Design Systems currently supports the AWS Cloudscape Design System, but we plan to expand support to other popular React design systems in the future:\n\n- **Material UI**: Comprehensive support for Google's Material Design implementation for React\n- **Chakra UI**: Component-focused support for the accessible and customizable Chakra UI library\n- **Ant Design**: Enterprise-grade UI system for React applications\n- **Blueprint**: Support for Palantir's UI toolkit for web applications\n- **Mantine**: Modern React components with excellent dark mode support\n\nIf you're interested in contributing support for additional design systems, please check out our [Contributing](#contributing) guidelines.\n\n## Using as a Dependency\n\nWhen using this package as a dependency in your project, you can import and use it as follows:\n\n```javascript\n// CommonJS\nconst { createReactDesignSystemsServer } = require('@agentience/react-design-systems-mcp');\n\n// ES Modules\nimport { createReactDesignSystemsServer } from '@agentience/react-design-systems-mcp';\n\n// Create and configure the server\nconst server = createReactDesignSystemsServer({\n  // Configuration options\n});\n\n// Start the server\nserver.start();\n```\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## License\n\nMIT - See [LICENSE](LICENSE) for more information.## Available Documentation\n\n- [React Design Systems Development](./DEVELOPMENT.md)\n- [Docker Deployment for React Design Systems](./DOCKER.md)\n- [React Design Systems v1.0.4](./release-notes.md)","readmeFilename":"README.md"}