Parts MCP

Un servidor del Protocolo de Contexto de Modelos (MCP) para el aprovisionamiento de piezas electrónicas con integración multi-EDA.

Descripción general

Parts MCP permite a los asistentes de IA buscar componentes electrónicos, comparar precios, comprobar la disponibilidad y procesar listas de materiales (BOM) de herramientas EDA populares. Proporciona una interfaz unificada para flujos de trabajo de aprovisionamiento de componentes impulsada por la API de Source Parts.

Herramientas EDA compatibles

Características

• Búsqueda universal de piezas: Busca millones de piezas a través de la API de Source Parts

• Procesamiento de BOM multi-EDA: Importa BOMs de KiCad, Altium, Fusion360, Eagle, PADS, Protel99

• Coincidencia de componentes: Coincidencia impulsada por IA con puntuación de confianza

• Comparación de precios: Compara precios entre distribuidores

• Comprobación de disponibilidad: Niveles de inventario en tiempo real

• Piezas alternativas: Encuentra reemplazos directos y equivalentes funcionales

• Integración CLI de KiCad: Genera BOMs directamente desde esquemáticos

• Caché local: Respuestas rápidas con almacenamiento en caché inteligente

Instalación

Inicio rápido (Recomendado)

uvx parts-mcp

No requiere instalación: uvx lo ejecuta directamente desde PyPI en un entorno aislado.

Con pip

pip install parts-mcp

Desde el código fuente

git clone https://github.com/SourceParts/parts-mcp.git
cd parts-mcp
pip install -e .

Requisitos

• Python 3.10+

• Clave de API de Source Parts (obtén una aquí)

Configuración

Crea un archivo .env o establece variables de entorno:

# Required
SOURCE_PARTS_API_KEY=your_api_key_here

# Optional
SOURCE_PARTS_API_URL=https://api.source.parts/v1
KICAD_SEARCH_PATHS=/path/to/kicad/projects
PARTS_CACHE_DIR=~/.cache/parts-mcp
CACHE_EXPIRY_HOURS=24

Integración con Claude Desktop

Añádelo a tu archivo de configuración de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "parts": {
      "command": "uvx",
      "args": ["parts-mcp"],
      "env": {
        "SOURCE_PARTS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Si se instaló desde el código fuente:

{
  "mcpServers": {
    "parts": {
      "command": "/path/to/python",
      "args": ["/path/to/parts-mcp/main.py"],
      "env": {
        "SOURCE_PARTS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Después de añadir la configuración, reinicia Claude Desktop.

Integración con Claude.ai (Remota)

Conéctate directamente desde claude.ai sin ninguna instalación local:

1. Abre claude.ai en tu navegador

2. Ve a Settings > Connectors

3. Haz clic en Add custom connector

4. Introduce la URL: https://mcp.source.parts/

5. Completa el inicio de sesión OAuth cuando se te solicite

6. Empieza a usar las herramientas de Parts en cualquier conversación

No se necesita clave de API: la autenticación se gestiona mediante OAuth.

Integración con Claude Code

Añádelo a tus ajustes de MCP de Claude Code (~/.claude/settings.json):

{
  "mcpServers": {
    "parts": {
      "command": "uvx",
      "args": ["parts-mcp"],
      "env": {
        "SOURCE_PARTS_API_KEY": "your_api_key_here"
      }
    }
  }
}

O ejecútalo directamente:

claude --mcp-server "python -m parts_mcp"

Ejemplos de uso

Buscar piezas

"Busca una resistencia de 10k en encapsulado 0603"

Procesar una BOM

"Sube mi BOM de Altium y encuentra los mejores precios para 100 unidades"

Integración con KiCad

"Extrae la BOM de mi amplifier.kicad_sch y busca todos los componentes"

Encontrar alternativas

"Encuentra alternativas para el obsoleto LM358"

Comprobar disponibilidad

"Comprueba los niveles de stock para el STM32F103C8T6"

Herramientas disponibles

Arquitectura

Parts MCP sigue una arquitectura de cliente ligero:

Local (MCP):

• Operaciones CLI de KiCad

• Descubrimiento de proyectos

• Caché de respuestas

• Análisis de archivos BOM

Servidor (API de Source Parts):

• Coincidencia de componentes

• Agregación de precios

• Comprobación de inventario

• Búsqueda de alternativas

Desarrollo

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run with debug logging
DEBUG=1 python main.py

Estructura del proyecto

parts_mcp/
├── server.py          # MCP server entry
├── config.py          # Configuration
├── tools/             # MCP tools
├── resources/         # MCP resources
├── prompts/           # Prompt templates
└── utils/
    ├── api_client.py        # Source Parts API client
    ├── bom_parser.py        # Multi-EDA BOM parsing
    ├── component_matcher.py # Component matching
    ├── cache.py             # Response caching
    └── kicad_utils.py       # KiCad CLI integration

Listados en el Marketplace

• MCP Registry - Registro oficial de servidores MCP

• Smithery - Marketplace de instalación con un clic

• Servidor alojado - MCP remoto para conectores de claude.ai

Enlaces

• Source Parts - Plataforma de búsqueda de componentes

• Documentación de la API de Source Parts - Documentación de la API

• Especificación MCP - Protocolo de Contexto de Modelos

Licencia

Licencia MIT con protección de marca registrada - ver LICENSE.md

"Source Parts" es una marca registrada. Consulta la licencia para conocer las restricciones de uso.