npm package: @solderable/mcp
Description: MCP client bridge for solderable.dev - connects Claude Desktop via stdio to HTTP endpoint
Author: Solderable
Latest version: 1.0.3

# 🔌 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)

```bash
npx @solderable/mcp
```

### Option 2: Install Globally

```bash
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:

```json
{
  "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

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

## 🔧 Troubleshooting

### Tools Not Showing Up?

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

### Connection Issues?

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

### Still Having Problems?

1. **Test the package directly**:
   ```bash
   echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | npx @solderable/mcp
   ```

2. **Check the logs** - Enable debug mode and look for error messages

3. **Verify the server** - Visit [solderable.dev](https://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:**
1. "Search for a voltage regulator that outputs 3.3V"
2. "What's the operating voltage range for part C12345?"
3. "Find me a cheaper alternative to C12345"

**Design Research:**
1. "What are the pin functions for ESP32-WROOM-32?"
2. "Find me a buck converter that can handle 5V input"
3. "What's the typical efficiency of switching regulators?"

## 📄 License

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

## 🔗 Links

- **Solderable Website**: [solderable.dev](https://solderable.dev)
- **MCP Documentation**: [modelcontextprotocol.io](https://modelcontextprotocol.io)

---

**Happy building! 🛠️**