Parts MCP

다중 EDA 통합을 지원하는 전자 부품 소싱용 MCP(Model Context Protocol) 서버입니다.

개요

Parts MCP를 사용하면 AI 어시스턴트가 전자 부품을 검색하고, 가격을 비교하며, 재고를 확인하고, 인기 있는 EDA 도구의 BOM을 처리할 수 있습니다. Source Parts API를 기반으로 부품 소싱 워크플로우를 위한 통합 인터페이스를 제공합니다.

지원되는 EDA 도구

기능

• 범용 부품 검색: Source Parts API를 통해 수백만 개의 부품 검색

• 다중 EDA BOM 처리: KiCad, Altium, Fusion360, Eagle, PADS, Protel99의 BOM 가져오기

• 부품 매칭: 신뢰도 점수를 기반으로 한 AI 기반 매칭

• 가격 비교: 유통업체 간 가격 비교

• 재고 확인: 실시간 재고 수준 확인

• 대체 부품: 드롭인 교체품 및 기능적 동등 부품 찾기

• 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+

• Source Parts API 키 (여기서 발급)

구성

.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 통합

Claude Code MCP 설정(~/.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"

사용 예시

부품 검색

"0603 패키지의 10k 저항을 찾아줘"

BOM 처리

"내 Altium BOM을 업로드하고 100개 단위에 대한 최적의 가격을 찾아줘"

KiCad 통합

"amplifier.kicad_sch에서 BOM을 추출하고 모든 부품을 소싱해줘"

대체 부품 찾기

"단종된 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 - claude.ai 커넥터용 원격 MCP

링크

• Source Parts - 부품 검색 플랫폼

• Source Parts API 문서 - API 문서

• MCP 사양 - Model Context Protocol

라이선스

MIT 라이선스 (상표 보호 포함) - LICENSE.md 참조

"Source Parts"는 상표입니다. 사용 제한에 대해서는 라이선스를 참조하세요.