@solderable/mcp
v1.0.3
Published
MCP client bridge for solderable.dev - connects Claude Desktop via stdio to HTTP endpoint
Maintainers
Readme
🔌 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/mcpOption 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 totrue)
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 --versionin 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/mcpCheck 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! 🛠️
