MCP-Produktsuchserver

Ein auf dem Model Context Protocol (MCP) basierender Produktsuchserver, der es Claude ermöglicht, Produktkataloge anhand von Schlüsselwörtern zu durchsuchen und strukturierte Daten zurückzugeben.

Funktionen

Stellt drei Tools für Claude zur Verfügung:

Erste Schritte

1. Projekt klonen

git clone <your-repo-url>
cd mcp-product-search

2. Virtuelle Umgebung erstellen und Abhängigkeiten installieren

macOS / Linux:

python3 -m venv .venv
source .venv/bin/activate
pip install "mcp[cli]"

Windows:

python -m venv .venv
.venv\Scripts\activate
pip install "mcp[cli]"

Erfordert Python 3.10 oder höher. Überprüfbar mit python3 --version.

3. Im Browser testen

mcp dev server.py

Der Browser öffnet automatisch den MCP Inspector. Falls er sich nicht automatisch öffnet, rufen Sie die in der Konsole angezeigte Adresse manuell auf (normalerweise http://localhost:6274).

Verbindungsschritte:

1. Ändern Sie links unter Command den Pfad zum absoluten Pfad des Pythons in Ihrer virtuellen Umgebung:

   • macOS/Linux: /absoluter/pfad/mcp-product-search/.venv/bin/python

   • Windows: C:\absoluter\pfad\mcp-product-search\.venv\Scripts\python.exe

2. Geben Sie bei Arguments server.py ein.

3. Klicken Sie auf Connect. Wenn unten links Connected erscheint, war die Verbindung erfolgreich.

4. Klicken Sie oben auf den Tab Tools, wählen Sie ein Tool aus, geben Sie die Parameter ein und klicken Sie auf Run Tool.

4. Einbindung in Claude Desktop

Suchen Sie die Konfigurationsdatei:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Fügen Sie den folgenden Inhalt hinzu (ersetzen Sie ihn durch den tatsächlichen absoluten Pfad):

{
  "mcpServers": {
    "product-search": {
      "command": "/绝对路径/mcp-product-search/.venv/bin/python",
      "args": ["/绝对路径/mcp-product-search/server.py"]
    }
  }
}

Aktuellen absoluten Pfad anzeigen:

# macOS / Linux
pwd

# Windows
cd

Speichern Sie die Konfigurationsdatei und beenden Sie Claude Desktop vollständig, bevor Sie es neu starten.

5. Einbindung in Claude Code (Kommandozeile)

claude mcp add product-search \
  /绝对路径/mcp-product-search/.venv/bin/python \
  /绝对路径/mcp-product-search/server.py

Anwendungsbeispiele

Nach der Einbindung in Claude können Sie Fragen wie diese stellen:

帮我搜索苹果品牌的笔记本电脑
找一款评分 4.8 以上、价格不超过 300 美元的耳机
列出所有产品分类
查询产品 P003 的详细信息

Claude entscheidet automatisch, welches Tool aufgerufen werden soll, und gibt basierend auf den zurückgegebenen strukturierten Daten eine Antwort.

Parameterbeschreibung der Tools

search

Die Ergebnisse werden nach Bewertung (absteigend) und Preis (aufsteigend) sortiert.

Beispiel für Rückgabe:

{
  "keyword": "apple",
  "filters": { "category": "Laptops", "max_price": null, "min_rating": null },
  "total_results": 1,
  "products": [
    {
      "id": "P001",
      "name": "Apple MacBook Pro 14-inch M3",
      "category": "Laptops",
      "brand": "Apple",
      "price": 1999.0,
      "currency": "USD",
      "stock": 42,
      "rating": 4.8,
      "description": "14-inch Liquid Retina XDR display, M3 chip, 18GB RAM, 512GB SSD.",
      "tags": ["laptop", "apple", "macbook", "m3", "professional", "portable"]
    }
  ]
}

list_categories

Keine Parameter. Gibt alle Kategorienamen und die entsprechende Produktanzahl zurück.

get_product

Projektstruktur

mcp-product-search/
├── server.py        # MCP 服务器，定义工具
├── products.py      # 产品目录与搜索逻辑
├── pyproject.toml   # 项目依赖
└── README.md

Produktdaten erweitern

Der aktuelle Produktkatalog besteht aus 12 Beispieldaten in products.py. Um diese durch echte Daten zu ersetzen, müssen Sie lediglich die Funktion search_products() anpassen; server.py muss nicht geändert werden.