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

Настраивать

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

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

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

Непосредственно с использованием Python (для простой разработки):
python app.py
Использование Uvicorn (рекомендуется для разработки, обеспечивает автоматическую перезагрузку): Убедитесь, что uvicorn установлен (он находится в pyproject.toml ).
uvicorn app:mcp --reload --host 0.0.0.0 --port 8000
( app:mcp ссылается на экземпляр mcp``FastMCP в вашем файле app.py )
Использование установленного скрипта (если После успешного выполнения 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.