@solderable/mcp

🔌 solderable-mcp

Connect Claude Desktop to solderable.dev's electronic component search and datasheet tools!

This package bridges Claude Desktop (which uses stdio) to solderable.dev's HTTP MCP server, giving you instant access to:

• 🔍 Component Search: Find electronic components across LCSC's database
• 📄 Datasheet Query: Ask natural language questions about component specifications

🚀 Quick Start

Option 1: Use with npx (Recommended)

npx @solderable/mcp

Option 2: Install Globally

npm install -g @solderable/mcp

🎯 Setup with Claude Desktop

1. Find Your Config File

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

2. Add the Configuration

Add this to your config file:

{
  "mcpServers": {
    "solderable": {
      "command": "npx",
      "args": ["-y", "@solderable/mcp"]
    }
  }
}

3. Restart Claude Desktop

Important: Completely quit Claude Desktop (Cmd+Q on macOS) and restart it.

4. Test It Out!

Ask Claude:

• "What tools are available?"
• "Search for a 10k resistor in 0805 package"
• "What is the operating voltage for part C25804?"

🛠️ Available Tools

🔍 Component Search

Search for electronic components with natural language:

Examples:

• "10k resistor 0805"
• "ESP32 with WiFi and Bluetooth"
• "buck regulator 3.3V 1A"
• "capacitor 100nF ceramic"

Features:

• Search up to 10 components simultaneously
• Get specifications, pricing, and availability
• Access to LCSC's comprehensive database

📄 Datasheet Query

Ask questions about component datasheets:

Examples:

• "What is the maximum operating voltage?"
• "What are the GPIO pin functions?"
• "What is the typical supply current?"
• "What's the temperature range?"

Usage:

• Provide the LCSC part number (e.g., "C25804", "C12345")
• Ask your question in natural language
• Get AI-powered answers from the datasheet

⚙️ Configuration Options

Environment Variables

• DEBUG: Enable debug logging (set to true)

Example with Debug Mode

{
  "mcpServers": {
    "solderable": {
      "command": "npx",
      "args": ["-y", "@solderable/mcp"],
      "env": {
        "DEBUG": "true"
      }
    }
  }
}

🔧 Troubleshooting

Tools Not Showing Up?

• Check your config file - Make sure it's valid JSON
• Restart Claude Desktop - Completely quit and restart
• Verify npx works - Try npx --version in terminal
• Enable debug mode - Add "DEBUG": "true" to see what's happening

Connection Issues?

• Check internet connection - Make sure you can reach https://solderable.dev
• Check Claude Desktop logs - Look for error messages

Still Having Problems?

• Test the package directly:

  echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | npx @solderable/mcp
  

• Check the logs - Enable debug mode and look for error messages

• Verify the server - Visit solderable.dev to make sure it's working

💡 Tips & Tricks

Best Practices

• Be specific in your component searches for better results
• Use part numbers when you know them for datasheet queries
• Try different phrasings if you don't get the results you want

Example Workflows

Finding a Component:

• "Search for a voltage regulator that outputs 3.3V"
• "What's the operating voltage range for part C12345?"
• "Find me a cheaper alternative to C12345"

Design Research:

• "What are the pin functions for ESP32-WROOM-32?"
• "Find me a buck converter that can handle 5V input"
• "What's the typical efficiency of switching regulators?"

📄 License

MIT License - feel free to use this in your projects!

🔗 Links

• Solderable Website: solderable.dev
• MCP Documentation: modelcontextprotocol.io

Happy building! 🛠️