PhoneLCDParts MCP Server

手机LCD配件 MCP 服务器

该项目为模型上下文协议 (MCP) 服务器提供了一个工具，用于从phonelcdparts.com抓取产品搜索结果。

目的

主要工具scrape_phonelcdparts允许兼容 MCP 的客户端（例如 LLM 代理）根据搜索词在phonelcdparts.com网站上查询产品。它会返回包含产品名称、价格、直达 URL 和图片 URL 的结构化 JSON 数据。

这使得各种应用程序能够自动检索产品信息，例如价格跟踪、数据分析或集成到更大的 AI 驱动的工作流程中。

先决条件

• Python 3.12 或更高版本。
• uv （用于环境和包管理）。
• 有效的 Firecrawl API 密钥（来自firecrawl.dev ）。

设置

1. 克隆存储库（如果适用）或导航到项目目录：
   cd path/to/phonelcdpart-mcp
2. 使用uv创建并激活虚拟环境：
   uv venv source .venv/bin/activate
3. **配置 Firecrawl API 密钥：**在phonelcdpart-mcp项目根目录下创建一个名为.env的文件（即phonelcdpart-mcp/.env ）。将您的 Firecrawl API 密钥添加到此文件中：
   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指的是app.py文件中FastMCP的mcp实例。）
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
• **描述（来自文档字符串）：**根据给定的搜索查询从phonelcdparts.com抓取产品信息（名称、价格、URL、图像 URL）。
• 争论：
  • search_query （字符串）：产品搜索词（例如“iphone 15 pro max lcd”）。
• **返回：**字典列表，其中每个字典包含：
  • name （字符串）
  • price （字符串）
  • url （字符串）
  • image_url （字符串）

示例调用（概念性，使用 Python 客户端）：

该客户端代码将连接到您正在运行的 MCP 服务器并使用指定的搜索查询调用scrape_phonelcdparts工具，然后打印结构化的 JSON 结果。