troubleshooting

Troubleshooting

Common issues and solutions for the shadcn/ui MCP Server.

🐛 Common Issues

• Installation Issues - Problems with installation and setup
• Rate Limit Issues - GitHub API rate limiting problems
• Framework Issues - Framework-specific problems
• Integration Issues - Editor and tool integration problems
• Network Issues - Connection and proxy problems

🚨 Quick Fixes

Server Won't Start

# Check Node.js version
node --version  # Should be 18+

# Check if npx is available
npx --version

Rate Limit Errors

# Add GitHub token
npx @jpisnice/shadcn-ui-mcp-server --github-api-key ghp_your_token_here

Component Not Found

# Check available components first
# Ask AI assistant: "List all available components"

Framework Issues

# Verify framework selection
npx @jpisnice/shadcn-ui-mcp-server --framework svelte --help

🔧 Debug Mode

Enable verbose logging:

# Set debug environment variable
DEBUG=* npx @jpisnice/shadcn-ui-mcp-server --github-api-key ghp_your_token

📞 Getting Help

• 🐛 Report Issues
• 💬 Discussions
• 📖 Documentation

🔗 Next Steps

• Installation Issues - Detailed installation troubleshooting
• Rate Limit Issues - GitHub API problems
• Framework Issues - Framework-specific problems
• Integration Issues - Editor integration problems