Skip to content

bengineer19/digikey_mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DigiKey MCP Server

A Model Context Protocol (MCP) server for DigiKey's Product Search API using FastMCP.

Requirements

  • Python 3.10+
  • uv package manager
  • DigiKey API credentials (CLIENT_ID and CLIENT_SECRET)

Setup

1. Install dependencies

uv sync

2. Set up environment variables

Create a .env file in the project root:

CLIENT_ID=your_digikey_client_id
CLIENT_SECRET=your_digikey_client_secret
USE_SANDBOX=false

Set USE_SANDBOX=true to use DigiKey's sandbox environment for testing.

3. Run the server

uv run python digikey_mcp_server.py

Available Tools

Search Methods

  • keyword_search(keywords, limit=5, manufacturer_id=None, category_id=None, search_options=None, sort_field=None, sort_order="Ascending") - Search DigiKey products by keyword with sorting and filtering
  • search_manufacturers() - Get all product manufacturers
  • search_categories() - Get all product categories
  • search_product_substitutions(product_number, limit=10, search_options=None, exclude_marketplace=False) - Find substitute products

Product Details

  • product_details(product_number, manufacturer_id=None, customer_id="0") - Get detailed product information
  • get_category_by_id(category_id) - Get specific category details
  • get_product_media(product_number) - Get product images, documents, and videos
  • get_product_pricing(product_number, customer_id="0", requested_quantity=1) - Get detailed pricing information
  • get_digi_reel_pricing(product_number, requested_quantity, customer_id="0") - Get DigiReel pricing

Sort Options for keyword_search

Available sort fields:

  • Packaging - Sort by packaging type
  • ProductStatus - Sort by product status
  • DigiKeyProductNumber - Sort by DigiKey part number
  • ManufacturerProductNumber - Sort by manufacturer part number
  • Manufacturer - Sort by manufacturer name
  • MinimumQuantity - Sort by minimum order quantity
  • QuantityAvailable - Sort by available quantity
  • Price - Sort by price
  • Supplier - Sort by supplier
  • PriceManufacturerStandardPackage - Sort by manufacturer standard package price

Sort orders: Ascending or Descending

Search Options

Available filters for search methods:

  • LeadFree - Lead-free products only
  • RoHSCompliant - RoHS compliant products only
  • InStock - In-stock products only
  • HasDatasheet - Products with datasheets
  • HasProductPhoto - Products with photos
  • Has3DModel - Products with 3D models
  • NewProduct - New products only

Example Usage

The server exposes MCP tools that can be used by MCP clients like Claude Desktop, or programmatically via FastMCP clients.

Search Examples

# Basic keyword search
keyword_search("resistor", limit=10)

# Search with sorting by price (lowest first)
keyword_search("capacitor", limit=5, sort_field="Price", sort_order="Ascending")

# Search with filters
keyword_search("LED", limit=10, search_options="InStock,RoHSCompliant")

# Get product details
product_details("296-8875-1-ND")

# Get pricing for specific quantity
get_product_pricing("296-8875-1-ND", requested_quantity=100)

Claude Desktop Integration

Add this to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "digikey": {
      "command": "uv",
      "args": ["run", "python", "digikey_mcp_server.py"],
      "cwd": "/path/to/project"
    }
  }
}

About

An MCP for DigiKey

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages