PhoneLCDParts MCP-сервер

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

Цель

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

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

Related MCP server: Vinted-scrapper

Предпосылки

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