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-сервер

Этот проект предоставляет сервер Model Context Protocol (MCP) с инструментом для извлечения результатов поиска товаров с phonelcdparts.com .

Цель

Основной инструмент, scrape_phonelcdparts , позволяет MCP-совместимому клиенту (например, агенту LLM) запрашивать веб-сайт phonelcdparts.com для продуктов на основе поискового термина. Он возвращает структурированные данные JSON, содержащие название продукта, цену, прямой URL и URL изображения.

Это позволяет осуществлять автоматизированный поиск информации о продуктах для различных приложений, таких как отслеживание цен, анализ данных или интеграция в более крупные рабочие процессы на базе искусственного интеллекта.

Предпосылки

  • Python 3.12 или выше.
  • uv (для управления средой и пакетами).
  • Действительный ключ API Firecrawl (от firecrawl.dev ).

Настраивать

  1. Клонируйте репозиторий (если применимо) или перейдите в каталог проекта:
    cd path/to/phonelcdpart-mcp
  2. Создайте и активируйте виртуальную среду с помощью uv :
    uv venv source .venv/bin/activate
  3. Настройте ключ API Firecrawl: создайте файл с именем .env в корневом каталоге проекта phonelcdpart-mcp (т. е. phonelcdpart-mcp/.env ). Добавьте свой ключ API Firecrawl в этот файл:
    FIRECRAWL_API_KEY="YOUR_ACTUAL_FIRECRAWL_API_KEY_HERE"
    Приложение использует библиотеку python-dotenv для загрузки этого ключа во время выполнения.
  4. Установите зависимости с помощью uv :
    uv pip install .
    Это установит все зависимости, перечисленные в pyproject.toml , включая python-dotenv .

Запуск сервера MCP

У вас есть несколько вариантов запуска сервера:

  1. Непосредственно с использованием Python (для простой разработки):
    python app.py
  2. Использование Uvicorn (рекомендуется для разработки, обеспечивает автоматическую перезагрузку): Убедитесь, что uvicorn установлен (он находится в pyproject.toml ).
    uvicorn app:mcp --reload --host 0.0.0.0 --port 8000
    ( app:mcp ссылается на экземпляр mcp``FastMCP в вашем файле app.py )
  3. Использование установленного скрипта (если uv pip install . был успешным): После успешного выполнения uv pip install . скрипт, определенный в pyproject.toml , должен быть доступен:
    start-mcp
    Обычно для этого используется метод mcp.run() .

Сервер обычно запускается по адресу http://127.0.0.1:8000 или http://0.0.0.0:8000 .

Использование инструмента

После запуска сервера вы сможете взаимодействовать с ним с помощью любого MCP-совместимого клиента.

  • Название инструмента: scrape_phonelcdparts
  • Описание (из строки документации): Извлекает информацию о продукте (название, цена, URL, URL изображения) с phonelcdparts.com для заданного поискового запроса.
  • Аргумент:
    • search_query (строка): поисковый запрос продукта (например, «iphone 15 pro max lcd»).
  • Возвращает: список словарей, где каждый словарь содержит:
    • name (строка)
    • price (строка)
    • url (строка)
    • image_url (строка)

Пример вызова (концептуальный, с использованием клиента Python):

# (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())

Этот клиентский код подключится к работающему серверу MCP и вызовет инструмент scrape_phonelcdparts с указанным поисковым запросом, а затем выведет структурированные результаты JSON.

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

Веб-сервер, который извлекает информацию о продукте (название, цена, URL, изображение) с phonelcdparts.com по любому поисковому запросу.

  1. Цель
    1. Предпосылки
      1. Настраивать
        1. Запуск сервера MCP
          1. Использование инструмента

            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