Parts MCP

Сервер протокола контекста модели (MCP) для поиска электронных компонентов с интеграцией различных EDA-систем.

Обзор

Parts MCP позволяет ИИ-ассистентам искать электронные компоненты, сравнивать цены, проверять наличие и обрабатывать спецификации (BOM) из популярных EDA-инструментов. Он предоставляет унифицированный интерфейс для рабочих процессов поиска компонентов на базе Source Parts API.

Поддерживаемые EDA-инструменты

Функции

• Универсальный поиск компонентов: поиск миллионов деталей через API Source Parts

• Обработка BOM из различных EDA: импорт спецификаций из KiCad, Altium, Fusion360, Eagle, PADS, Protel99

• Сопоставление компонентов: сопоставление на базе ИИ с оценкой достоверности

• Сравнение цен: сравнение цен у различных дистрибьюторов

• Проверка наличия: уровни складских запасов в реальном времени

• Альтернативные компоненты: поиск взаимозаменяемых деталей и функциональных аналогов

• Интеграция с KiCad CLI: генерация BOM непосредственно из схем

• Локальное кэширование: быстрые ответы благодаря интеллектуальному кэшированию

Установка

Быстрый старт (рекомендуется)

uvx parts-mcp

Установка не требуется — uvx запускает его напрямую из PyPI в изолированной среде.

Через pip

pip install parts-mcp

Из исходного кода

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

Требования

• Python 3.10+

• API-ключ Source Parts (получить можно здесь)

Конфигурация

Создайте файл .env или установите переменные окружения:

# 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

Интеграция с Claude Desktop

Добавьте в файл конфигурации 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"
      }
    }
  }
}

При установке из исходного кода:

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

После добавления конфигурации перезапустите Claude Desktop.

Интеграция с Claude.ai (удаленная)

Подключайтесь напрямую с claude.ai без локальной установки:

1. Откройте claude.ai в браузере

2. Перейдите в Settings > Connectors

3. Нажмите Add custom connector

4. Введите URL: https://mcp.source.parts/

5. Выполните вход через OAuth при появлении запроса

6. Начните использовать инструменты Parts в любом диалоге

API-ключ не требуется — аутентификация выполняется через OAuth.

Интеграция с Claude Code

Добавьте в настройки MCP для Claude Code (~/.claude/settings.json):

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

Или запустите напрямую:

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

Примеры использования

Поиск компонентов

"Найди резистор 10к в корпусе 0603"

Обработка BOM

"Загрузи мой BOM из Altium и найди лучшие цены для 100 штук"

Интеграция с KiCad

"Извлеки BOM из моего amplifier.kicad_sch и найди поставщиков для всех компонентов"

Поиск альтернатив

"Найди альтернативы для устаревшего LM358"

Проверка наличия

"Проверь складские запасы для STM32F103C8T6"

Доступные инструменты

Архитектура

Parts MCP использует архитектуру «тонкого клиента»:

Локально (MCP):

• Операции KiCad CLI

• Обнаружение проектов

• Кэширование ответов

• Парсинг файлов BOM

Сервер (Source Parts API):

• Сопоставление компонентов

• Агрегация цен

• Проверка запасов

• Поиск альтернатив

Разработка

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

# Run tests
pytest

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

Структура проекта

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

Размещение на маркетплейсах

• MCP Registry — официальный реестр серверов MCP

• Smithery — маркетплейс с установкой в один клик

• Hosted Server — удаленный MCP для коннекторов claude.ai

Ссылки

• Source Parts — платформа поиска компонентов

• Документация API Source Parts — документация API

• Спецификация MCP — протокол контекста модели

Лицензия

Лицензия MIT с защитой товарных знаков — см. LICENSE.md

"Source Parts" является товарным знаком. См. лицензию для ограничений по использованию.