Skip to content

Getting Started with Fluorite MCP

Welcome to Fluorite MCP! This guide will help you quickly set up and start using Fluorite MCP with Claude Code CLI. For a detailed overview of what Fluorite MCP is, please see our Introduction.

📖 Table of Contents

Quick Start (5 minutes)

Step 1: Install Fluorite MCP

bash
# Install globally via npm
npm i -g fluorite-mcp

Step 2: Add to Claude Code CLI

bash
# Connect to Claude Code CLI
claude mcp add fluorite-mcp -- fluorite-mcp

Step 3: Verify Installation

bash
# Test the connection
claude mcp list
# You should see 'fluorite' in the list

Step 4: Try Your First Command

Open Claude Code and try:

Create a modern React data table with sorting and filtering using TypeScript

Claude will automatically use Fluorite MCP's knowledge of TanStack Table, TypeScript patterns, and best practices to generate production-ready code!

Your First Commands

Creating UI Components

Create a responsive navigation component using Radix UI and Tailwind CSS

What happens:

  • Claude accesses spec://radix-ui-themes
  • Uses proper TypeScript patterns
  • Includes accessibility features
  • Applies modern CSS practices

Building APIs

Create a FastAPI endpoint with JWT authentication and Pydantic validation

What happens:

  • Claude uses spec://fastapi-ecosystem
  • Includes security best practices
  • Proper error handling
  • Type-safe response models

Setting Up Testing

Set up Playwright testing with accessibility checking

What happens:

  • Uses spec://playwright-axe-accessibility
  • Configures proper test structure
  • Includes CI/CD integration
  • Adds accessibility validation

Spike Development

I need to experiment with drag-and-drop functionality for a tree component

What happens:

  • Claude suggests relevant spike templates
  • Provides rapid prototyping setup
  • Includes validation strategies
  • Offers integration guidance

Next Steps

📖 Learn More

Next StepTimePurpose
Installation Guide15 minDetailed setup and troubleshooting
Command Reference30 minMaster all available features
Spike Templates Guide20 minRapid prototyping techniques
API Documentation45 minComplete technical reference

🛠️ Advanced Usage

TopicGuideDescription
Custom SpecificationsTemplate CreationAdd your own library specs
Static Analysis RulesDeveloper GuideConfigure custom analysis rules
Team TemplatesTemplate CreationCreate and share team templates
Plugin DevelopmentDeveloper GuideBuild custom integrations

🤝 Community & Support

ResourceWhen to UseLink
Bug ReportsBug reports, feature requestsContact repository maintainer
Contributing GuideWant to help improve Fluorite MCPContributing
TroubleshootingHaving problems?Troubleshooting Guide

📚 Documentation Navigation

💡 Pro Tips

  1. Be Specific: Mention specific libraries or frameworks for best results

    ✅ "Create a form with react-hook-form and Zod validation"
    ❌ "Create a form"
  2. Use Technology Names: Claude can better select specifications

    ✅ "Build a Next.js API with tRPC and Prisma"
    ❌ "Build an API"
  3. Ask for Best Practices: Fluorite MCP includes extensive best practice knowledge

    ✅ "What are the best practices for Next.js authentication with NextAuth?"
  4. Leverage Static Analysis: Ask Claude to analyze existing code

    ✅ "Analyze this React component for potential issues"

🚀 What's Next?

You're now ready to supercharge your development workflow with Fluorite MCP! The system works transparently with Claude Code CLI, providing rich context and best practices for modern web development.

Start with simple requests and gradually explore more advanced features. The more specific you are about technologies and requirements, the better Fluorite MCP can assist you.

Happy coding! 🎉


Need help? Check our Troubleshooting Guide.

Released under the MIT License.