PhoneLCDParts

this is phonelcdparts mcp server use for AI to search through the site

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "cnguyen14-plp-mcpserver": {
      "command": "uvicorn",
      "args": [
        "app:mcp",
        "--reload",
        "--host",
        "0.0.0.0",
        "--port",
        "8000"
      ],
      "env": {
        "FIRECRAWL_API_KEY": "YOUR_ACTUAL_FIRECRAWL_API_KEY_HERE"
      }
    }
  }
}

You run a dedicated MCP server that exposes a tool to search phonelcdparts.com and return structured product data. This enables automated product lookup, data collection, and integration into AI-powered workflows with a simple, MCP-compatible interface.

How to use

Once your MCP server is running, you can invoke the tool scrape_phonelcdparts from any MCP-compatible client. Provide a search query such as a product name or keyword, and you will receive a list of product entries. Each entry includes the product name, price, direct URL, and image URL. Use the results to power price tracking, data analysis, or feed them into larger automation pipelines.

How to install

Prerequisites you need before starting: Python 3.12 or higher, the uv tool for environment and package management, and a valid Firecrawl API key.

cd path/to/phonelcdpart-mcp

uv venv
source .venv/bin/activate

FIRECRAWL_API_KEY="YOUR_ACTUAL_FIRECRAWL_API_KEY_HERE"

Create the environment variable file to load the API key at runtime. The key should be kept private and not shared publicly.

uv pip install .


Install all dependencies listed in the project configuration.

Create a configuration file to store your API key if you prefer not to rely on environment variables alone. The application uses python-dotenv to load the key at runtime.

Additional sections

Starting the MCP server can be done in several ways. Choose the method that fits your development or deployment needs.

# Direct Python run (suitable for simple development)
python app.py

# Run with Uvicorn (recommended for development with auto-reload)
uvicorn app:mcp --reload --host 0.0.0.0 --port 8000

# Start via installed script after a successful install
start-mcp

Available tools

scrape_phonelcdparts

Fetches product information (name, price, URL, image URL) from phonelcdparts.com for a given search query and returns a list of dictionaries.