PhoneLCDParts MCP Server

by cnguyen14
Integrations
  • Provides a tool for scraping product search results from phonelcdparts.com using Firecrawl and BeautifulSoup, retrieving product information including name, price, URL, and image for any search query.

PhoneLCDParts MCP-Server

Dieses Projekt stellt einen Model Context Protocol (MCP)-Server mit einem Tool zum Scrapen von Produktsuchergebnissen von phonelcdparts.com bereit.

Zweck

Das primäre Tool, scrape_phonelcdparts , ermöglicht es einem MCP-kompatiblen Client (z. B. einem LLM-Agenten), die Website phonelcdparts.com anhand eines Suchbegriffs nach Produkten abzufragen. Es gibt strukturierte JSON-Daten zurück, die den Produktnamen, den Preis, die direkte URL und die Bild-URL enthalten.

Dies ermöglicht den automatisierten Abruf von Produktinformationen für verschiedene Anwendungen, wie z. B. Preisverfolgung, Datenanalyse oder Integration in größere KI-gesteuerte Arbeitsabläufe.

Voraussetzungen

  • Python 3.12 oder höher.
  • uv (für Umgebungs- und Paketverwaltung).
  • Ein gültiger Firecrawl-API-Schlüssel (von firecrawl.dev ).

Aufstellen

  1. Klonen Sie das Repository (falls zutreffend) oder navigieren Sie zum Projektverzeichnis:
    cd path/to/phonelcdpart-mcp
  2. Erstellen und aktivieren Sie eine virtuelle Umgebung mit uv :
    uv venv source .venv/bin/activate
  3. Konfigurieren Sie den Firecrawl-API-Schlüssel: Erstellen Sie eine Datei mit dem Namen .env im Stammverzeichnis des Projekts phonelcdpart-mcp (z. B. phonelcdpart-mcp/.env ). Fügen Sie Ihren Firecrawl-API-Schlüssel zu dieser Datei hinzu:
    FIRECRAWL_API_KEY="YOUR_ACTUAL_FIRECRAWL_API_KEY_HERE"
    Die Anwendung verwendet die python-dotenv -Bibliothek, um diesen Schlüssel zur Laufzeit zu laden.
  4. Installieren Sie Abhängigkeiten mit uv :
    uv pip install .
    Dadurch werden alle in pyproject.toml aufgeführten Abhängigkeiten installiert, einschließlich python-dotenv .

Ausführen des MCP-Servers

Sie haben mehrere Möglichkeiten, den Server auszuführen:

  1. Direkt mit Python (für einfache Entwicklung):
    python app.py
  2. Verwenden von Uvicorn (für die Entwicklung empfohlen, bietet automatisches Neuladen): Stellen Sie sicher, dass uvicorn installiert ist (es befindet sich in pyproject.toml ).
    uvicorn app:mcp --reload --host 0.0.0.0 --port 8000
    ( app:mcp bezieht sich auf die mcp -Instanz von FastMCP in Ihrer app.py Datei.)
  3. Verwenden des installierten Skripts (wenn uv pip install . erfolgreich war): Nach einem erfolgreichen uv pip install . sollte ein in pyproject.toml definiertes Skript verfügbar sein:
    start-mcp
    Dazu wird normalerweise die Methode mcp.run() verwendet.

Der Server startet normalerweise unter http://127.0.0.1:8000 oder http://0.0.0.0:8000 .

Verwenden des Tools

Sobald der Server läuft, können Sie mit jedem MCP-kompatiblen Client mit ihm interagieren.

  • Werkzeugname: scrape_phonelcdparts
  • Beschreibung (aus der Dokumentzeichenfolge): Kratzt Produktinformationen (Name, Preis, URL, Bild-URL) von phonelcdparts.com für eine bestimmte Suchanfrage.
  • Argument:
    • search_query (Zeichenfolge): Der Produktsuchbegriff (z. B. „iPhone 15 Pro Max LCD“).
  • Gibt zurück: Eine Liste von Wörterbüchern, wobei jedes Wörterbuch Folgendes enthält:
    • name (Zeichenfolge)
    • price (Zeichenfolge)
    • url (Zeichenfolge)
    • image_url (Zeichenfolge)

Beispielaufruf (konzeptionell, unter Verwendung eines Python-Clients):

# (This is a conceptual example of how a client might call the tool) # import asyncio # from fastmcp import Client # # async def main(): # # Ensure the server_url matches where your MCP server is running # server_url = "http://127.0.0.1:8000/sse" # async with Client(server_url) as client: # try: # result = await client.call_tool( # "scrape_phonelcdparts", # {"search_query": "iphone 14 screen"} # ) # if result and result.data: # print("Tool Result:") # for item in result.data: # print(item) # else: # print("No data returned or tool call failed.") # except Exception as e: # print(f"Error calling tool: {e}") # # if __name__ == "__main__": # asyncio.run(main())

Dieser Clientcode würde eine Verbindung zu Ihrem laufenden MCP-Server herstellen und das Tool scrape_phonelcdparts mit der angegebenen Suchanfrage aufrufen und dann die strukturierten JSON-Ergebnisse drucken.

-
security - not tested
F
license - not found
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Ein Web-Scraping-Server, der für jede Suchanfrage Produktinformationen (Name, Preis, URL, Bild) von phonelcdparts.com abruft.

  1. Zweck
    1. Voraussetzungen
      1. Aufstellen
        1. Ausführen des MCP-Servers
          1. Verwenden des Tools

            Related MCP Servers

            • A
              security
              F
              license
              A
              quality
              A server that provides tools to scrape websites and extract structured data from them using Firecrawl's APIs, supporting both basic website scraping in multiple formats and custom schema-based data extraction.
              Last updated -
              2
              JavaScript
            • -
              security
              A
              license
              -
              quality
              Searching google, individual websites and scraping their content. Fast and cost-effective. ⚡️
              Last updated -
              16
              TypeScript
              MIT License
            • -
              security
              -
              license
              -
              quality
              Enables free web searching using Google search results with no API keys required, returning structured results with titles, URLs, and descriptions.
              Last updated -
              6
            • -
              security
              F
              license
              -
              quality
              Provides functionality to fetch and transform web content in various formats (HTML, JSON, plain text, and Markdown) through simple API calls.
              Last updated -
              125,855
              TypeScript

            View all related MCP servers

            ID: y8mxju85yt