# ICBOMS MCP Server

[![Model Context Protocol](https://img.shields.io/badge/MCP-Standard-blue.svg)](https://modelcontextprotocol.io/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![ICBOMS](https://img.shields.io/badge/Catalog-5M%2B%20Parts-green.svg)](https://icboms.com)

Official [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for **[ICBOMS](https://icboms.com)** — an independent electronic components, IC, and semiconductor distribution platform.

Connect AI coding assistants (Claude Desktop, Cursor, Windsurf, Claude Code, Antigravity) directly to the ICBOMS catalog to search millions of components, check electrical specifications, compare alternates, and request turnkey BOM procurement.

---

## 🌟 Key Features

- 🔍 **Parametric Component Search**: Search 5M+ active and hard-to-find MPNs, microcontrollers (STM32, NXP, Microchip, ESP32), power management ICs, discretes, and passives directly from your AI agent.
- 📋 **Product Facts & Specs**: Fetch verified parametric specifications, package data, pin counts, and manufacturer datasheets.
- 🔄 **Cross-Reference & Alternates**: Compare pin-to-pin compatible alternatives for obsolete, allocation-constrained, or high-cost components.
- 📦 **Turnkey BOM Line-Matching**: Generate complete BOM procurement requests backed by Shenzhen supply-chain consolidation with international DDP delivery.
- 🇷🇺 **Dedicated Russian & CIS Logistics**: Full Russian language support at [icboms.com/ru](https://icboms.com/ru) with customs-cleared DDP turnkey delivery to Russian contract manufacturers and EMS facilities.

---

## 🚀 Quick Start

### 1. Claude Desktop

Add the following to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "icboms": {
      "command": "node",
      "args": ["/path/to/icboms-mcp-server/index.js"]
    }
  }
}
```

Or run via npx:

```json
{
  "mcpServers": {
    "icboms": {
      "command": "npx",
      "args": ["-y", "icboms-mcp-server"]
    }
  }
}
```

### 2. Claude Code

```bash
claude mcp add icboms -- node /path/to/icboms-mcp-server/index.js
```

### 3. Cursor & Windsurf

Add the server in your Cursor / Windsurf Settings under **MCP Servers**:
- **Name**: `icboms`
- **Command**: `node /path/to/icboms-mcp-server/index.js`

---

## 🛠 Available Tools

| Tool | Description | Example Input |
|---|---|---|
| `icboms_search_components` | Search electronic components and ICs across the ICBOMS catalog | `{"query": "STM32F407VET6", "limit": 5}` |
| `icboms_get_product_facts` | Retrieve electrical specifications, package, and manufacturer data | `{"mpn": "CC2541F256RHAT"}` |
| `icboms_compare_parts` | Compare 2 to 8 MPNs side-by-side for alternates and replacement | `{"mpns": ["STM32F103C8T6", "GD32F103C8T6"]}` |
| `icboms_procurement_rfq` | Submit BOM line items for turnkey procurement and DDP freight | `{"bom_lines": [{"mpn": "LM358DR", "quantity": 1000}], "destination_country": "Russia"}` |

---

## 🌐 Machine-Readable Endpoints & AI Feeds

ICBOMS natively provides open AI-ready endpoints:

- **AI Profile & Policy**: [https://icboms.com/llms.txt](https://icboms.com/llms.txt)
- **Extended Profile**: [https://icboms.com/llms-full.txt](https://icboms.com/llms-full.txt)
- **OpenAPI Schema**: [https://icboms.com/openapi.json](https://icboms.com/openapi.json)
- **Component Facts Feed**: [https://icboms.com/api/mcp/products/index.json](https://icboms.com/api/mcp/products/index.json)
- **Global Catalog**: [https://icboms.com/products](https://icboms.com/products)
- **Russian Portal**: [https://icboms.com/ru](https://icboms.com/ru)

---

## 🛡 Quality & Authenticity Guarantee

All parts sourced through ICBOMS adhere to strict supply-chain controls:
- **100% Genuine & Brand New**: Direct manufacturer or authorized distributor traceable channels.
- **Pre-Shipment Verification**: High-resolution packaging, label, and batch photos/videos provided for customer sign-off prior to dispatch.
- **Third-Party Testing Options**: Independent lab decapsulation, X-ray inspection, and XRF analysis available on request.

---

## 📞 Contact & Inquiries

- **Global Website**: [https://icboms.com](https://icboms.com)
- **Russian Website**: [https://icboms.com/ru](https://icboms.com/ru)
- **Email**: [sales@icboms.com](mailto:sales@icboms.com)
- **Procurement Desk**: [https://icboms.com/procurement](https://icboms.com/procurement)
- **WhatsApp / Telegram**: +86 15989861989
- **Warehouse**: Shenzhen, Guangdong, China

## License

MIT License. See [LICENSE](./LICENSE) for details.