Mouser Electronics MCP Server

A Model Context Protocol (MCP) server for the Mouser Electronics API. Search for electronic components, manage shopping carts, and track orders directly through Claude or other MCP clients.

Features

• Part Search: Find components by keyword or exact part number

• Component Details: Access specifications, pricing, availability, and datasheets

• Cart Management: Add items to cart and update quantities

• Order Tracking: View order details and history

• Pricing Information: Get quantity-based pricing with up to 4 price breaks

• Real-time Availability: Check stock levels and lead times

Related MCP server: codebeamer-mcp

Quick Start

Prerequisites

• Python 3.10 or higher

• uv package manager (recommended)

• Mouser Electronics API keys (free at mouser.com/api-hub)

Installation

1. Clone this repository:

git clone <this-repo> mouser-mcp
cd mouser-mcp

2. Install dependencies:

uv sync

3. Create your environment file:

cp .env.example .env
# Edit .env with your Mouser API keys

You'll need two separate API keys from Mouser:

• Part Search API Key: For searching components

• Order/Cart API Key: For cart and order operations

Get both keys at: https://www.mouser.com/api-hub/

4. Run the server:

uv run mouser-mcp

Project Structure

mouser-mcp/
├── src/mouser_mcp/
│   ├── __init__.py          # Package initialization
│   ├── server.py            # Main MCP server entry point
│   ├── client.py            # Mouser API client
│   ├── types.py             # TypedDict definitions
│   ├── api/                 # API modules
│   │   ├── search.py        # Search operations
│   │   ├── cart.py          # Cart management
│   │   ├── order.py         # Order operations
│   │   └── order_history.py # Order history
│   └── utils/               # Utility modules
├── tests/                   # Test suite
├── .env.example             # Environment template
└── README.md               # This file

Available Tools

Environment Variables

Claude Desktop Integration

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "mouser": {
      "command": "uv",
      "args": ["--directory", "/path/to/mouser-mcp", "run", "mouser-mcp"]
    }
  }
}

Or with Docker:

{
  "mcpServers": {
    "mouser": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--env-file",
        "/path/to/mouser-mcp/.env",
        "mouser-mcp:latest"
      ]
    }
  }
}

Development

Running Tests

# Run all tests (unit tests only, no API keys needed)
uv run python -m pytest -v

# Run integration tests (requires real Mouser API keys)
uv run python -m pytest tests/test_search_integration.py -v -s

# Run specific test
uv run python -m pytest tests/test_search_integration.py::test_search_arduino_boards_integration -v -s

Linting

uv run ruff check src/ tests/
uv run ruff format src/ tests/

Building

uv build

Troubleshooting

"Invalid unique identifier" Error

Problem: When searching for parts, you get:

{
  "Errors": [{
    "Code": "Invalid",
    "Message": "Invalid unique identifier.",
    "PropertyName": "API Key"
  }]
}

Solution: The API keys in your .env file are placeholders. You need to:

1. Get real API keys from Mouser API Hub

2. Update your .env file with the actual keys

See API_KEY_SETUP.md for detailed instructions.

Rate Limit Errors

If you see rate limit errors, wait at least 1 minute before retrying. Consider implementing:

• Request throttling in your application

• Caching of search results

• Batch operations where possible

Empty Search Results

If searches return no results:

• Verify the part exists on mouser.com

• Try broader search terms

• Check for typos in part numbers

For more troubleshooting help, see INVESTIGATION_SUMMARY.md

Docker Deployment

Build and run with Docker Compose:

docker compose up --build

For development with VS Code Dev Containers:

1. Open the project in VS Code

2. Install the "Dev Containers" extension

3. Click "Reopen in Container" when prompted

API Rate Limits

Mouser API has the following limits:

• 50 results maximum per search request

• 30 requests per minute

• 1000 requests per day

The server will raise errors if you exceed these limits.

Example Usage

Once integrated with Claude Desktop, you can ask:

• "Search for STM32F407 microcontrollers on Mouser"

• "Find 10k ohm resistors with 1% tolerance"

• "What's the price and availability for part number 595-TPS54360DDAR?"

• "Show me my recent Mouser orders"

License

MIT License - See LICENSE file for details.

Contributing

1. Fork the repository

2. Create a feature branch

3. Make your changes

4. Run tests and linting

5. Submit a pull request

Resources

• Mouser API Hub

• Mouser API Documentation

• Model Context Protocol

• FastMCP Documentation