DigiKey

Pesquise por componentes eletrônicos e produtos usando a API de Pesquisa de Produtos DigiKey.

Documentação

Servidor MCP DigiKey

Um servidor Model Context Protocol (MCP) para a API de Pesquisa de Produtos da DigiKey usando FastMCP.

Requisitos

  • Python 3.10+
  • Gerenciador de pacotes uv
  • Credenciais da API DigiKey (CLIENT_ID e CLIENT_SECRET)

Configuração

1. Instalar dependências

uv sync

2. Configurar variáveis de ambiente

Crie um arquivo .env na raiz do projeto:

CLIENT_ID=your_digikey_client_id
CLIENT_SECRET=your_digikey_client_secret
USE_SANDBOX=false

Defina USE_SANDBOX=true para usar o ambiente sandbox da DigiKey para testes.

3. Executar o servidor

uv run python digikey_mcp_server.py

Ferramentas Disponíveis

Métodos de Pesquisa

  • keyword_search(keywords, limit=5, manufacturer_id=None, category_id=None, search_options=None, sort_field=None, sort_order="Ascending") - Pesquisar produtos DigiKey por palavra-chave com ordenação e filtros
  • search_manufacturers() - Obter todos os fabricantes de produtos
  • search_categories() - Obter todas as categorias de produtos
  • search_product_substitutions(product_number, limit=10, search_options=None, exclude_marketplace=False) - Encontrar produtos substitutos

Detalhes do Produto

  • product_details(product_number, manufacturer_id=None, customer_id="0") - Obter informações detalhadas do produto
  • get_category_by_id(category_id) - Obter detalhes de uma categoria específica
  • get_product_media(product_number) - Obter imagens, documentos e vídeos do produto
  • get_product_pricing(product_number, customer_id="0", requested_quantity=1) - Obter informações detalhadas de preços
  • get_digi_reel_pricing(product_number, requested_quantity, customer_id="0") - Obter preços do DigiReel

Opções de Ordenação para keyword_search

Campos de ordenação disponíveis:

  • Packaging - Ordenar por tipo de embalagem
  • ProductStatus - Ordenar por status do produto
  • DigiKeyProductNumber - Ordenar por número da peça DigiKey
  • ManufacturerProductNumber - Ordenar por número da peça do fabricante
  • Manufacturer - Ordenar por nome do fabricante
  • MinimumQuantity - Ordenar por quantidade mínima de pedido
  • QuantityAvailable - Ordenar por quantidade disponível
  • Price - Ordenar por preço
  • Supplier - Ordenar por fornecedor
  • PriceManufacturerStandardPackage - Ordenar por preço padrão do pacote do fabricante

Ordens de ordenação: Ascending ou Descending

Opções de Pesquisa

Filtros disponíveis para métodos de pesquisa:

  • LeadFree - Apenas produtos sem chumbo
  • RoHSCompliant - Apenas produtos em conformidade com RoHS
  • InStock - Apenas produtos em estoque
  • HasDatasheet - Produtos com folhas de dados
  • HasProductPhoto - Produtos com fotos
  • Has3DModel - Produtos com modelos 3D
  • NewProduct - Apenas produtos novos

Exemplo de Uso

O servidor expõe ferramentas MCP que podem ser usadas por clientes MCP como Claude Desktop, ou programaticamente via clientes FastMCP.

Exemplos de Pesquisa

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

Integração com Claude Desktop

Adicione isto à sua configuração do Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json no macOS):

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