{"id":18671,"library":"polaris-mcp-server","title":"Polaris MCP Server","description":"A Model Context Protocol (MCP) server that provides tools and prompts for working with Shopify Polaris UI components. Version 1.0.0 enables AI assistants to search components, get detailed props and best practices, and retrieve code examples. It supports Node.js >=14.17.0 and is designed for Cursor or Claude Desktop integration. Key differentiators: specialized prompts for component implementation and layout design, and direct access to Polaris component data without manual documentation lookups.","status":"active","version":"1.0.0","language":"javascript","source_language":"en","source_url":"https://github.com/shramiknakarmi/polaris-mcp-server","tags":["javascript","shopify","polaris","mcp","ui","components"],"install":[{"cmd":"npm install polaris-mcp-server","lang":"bash","label":"npm"},{"cmd":"yarn add polaris-mcp-server","lang":"bash","label":"yarn"},{"cmd":"pnpm add polaris-mcp-server","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Core SDK for implementing MCP server","package":"@modelcontextprotocol/sdk","optional":false}],"imports":[{"note":"ESM-only. SDK version must be compatible with MCP protocol.","symbol":"Server","correct":"import { Server } from '@modelcontextprotocol/sdk/server/index.js'"},{"note":"Exported from subpath 'server/stdio.js', not root.","wrong":"import { StdioServerTransport } from '@modelcontextprotocol/sdk'","symbol":"StdioServerTransport","correct":"import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'"},{"note":"Type schema for tool requests.","symbol":"CallToolRequestSchema","correct":"import { CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js'"}],"quickstart":{"code":"// Add to MCP client config (e.g., Cursor or Claude Desktop):\n// {\n//   \"mcpServers\": {\n//     \"polaris-mcp-server\": {\n//       \"command\": \"npx\",\n//       \"args\": [\"-y\", \"polaris-mcp-server@latest\"]\n//     }\n//   }\n// }\n\n// Then use in your AI assistant:\n// Search for components\nconst result = await use_mcp_tool('polaris-mcp-server', 'search_polaris_components', {\n  query: 'button',\n  category: 'Actions'\n});\n\n// Get details\nconst details = await use_mcp_tool('polaris-mcp-server', 'get_component_details', {\n  componentName: 'Button'\n});\n\n// Get examples\nconst examples = await use_mcp_tool('polaris-mcp-server', 'get_component_examples', {\n  componentName: 'Button'\n});","lang":"typescript","description":"Configures the MCP client to use polaris-mcp-server and demonstrates calling the three available tools: search, details, examples."},"warnings":[{"fix":"Use the alternative Windows config: { command: 'cmd', args: ['/k', 'npx', '-y', 'polaris-mcp-server'] }","message":"Windows users must use 'cmd /k npx -y polaris-mcp-server' instead of direct npx command.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Re-run 'npm run scrape' to update component data.","message":"The 'get_component_examples' tool may return stale examples if the data folder is not refreshed.","severity":"deprecated","affected_versions":">=1.0.0"},{"fix":"Re-generate the data by running the scraper script periodically.","message":"Component data is pre-scraped and bundled; it may not reflect the latest Polaris documentation.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Ensure npx fetches the package correctly; if using local install, run 'npm install @modelcontextprotocol/sdk'.","cause":"Missing dependency when running via npx without installing locally.","error":"Error: Cannot find module '@modelcontextprotocol/sdk'"},{"fix":"Kill the previous process or use a different transport (e.g., change port if using SSE).","cause":"Another instance of the MCP server is already running using the same transport.","error":"Error: listen EADDRINUSE :::0"},{"fix":"Check server logs for startup errors. Ensure client configuration points to the correct server name.","cause":"Client is connecting to a different MCP server or the server failed to register tools.","error":"Tool not found: search_polaris_components"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}