cnguyen14/PartVendorSearch-MCP

URLVendor MCP Server

A Model Context Protocol (MCP) server that provides access to mobile device repair parts vendors through AI-powered search tools. Search across InjuredGadgets, MobileSentrix, WholesaleGadgetParts, and PhoneLCDParts simultaneously or individually.

🚀 Features

• Multi-vendor Search: Query 4 major mobile repair parts vendors simultaneously
• Individual Vendor Tools: Search specific vendors when you know where to look
• STDIO Transport: Compatible with Claude Desktop and other MCP clients
• uvx Support: Easy installation and execution via uvx
• Structured Output: Consistent JSON responses with product details
• Error Handling: Robust error handling and fallback mechanisms

🛠 Supported Vendors

📦 Installation

Using uvx (Recommended)

# Install and run directly
uvx urlvendor-mcp-server

# Or install from GitHub
uvx git+https://github.com/cnguyen14/PartVendorSearch-MCP.git

Using pip

# Install
pip install urlvendor-mcp-server

# Run
urlvendor-mcp-server

From Source

# Clone repository
git clone https://github.com/cnguyen14/PartVendorSearch-MCP.git
cd PartVendorSearch-MCP

# Install dependencies
uv sync

# Run server
uv run urlvendor-mcp-server

🔧 Configuration

Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "urlvendor": {
      "command": "uvx",
      "args": ["git+https://github.com/cnguyen14/PartVendorSearch-MCP.git"]
    }
  }
}

Claude Code

Add to Claude Code using the built-in MCP management:

# Quick add command
claude mcp add partvendor -- uvx git+https://github.com/cnguyen14/PartVendorSearch-MCP.git

# Alternative JSON format
claude mcp add-json "partvendor" '{"command":"uvx","args":["git+https://github.com/cnguyen14/PartVendorSearch-MCP.git"]}'

# Project-specific installation
claude mcp add -s project partvendor -- uvx git+https://github.com/cnguyen14/PartVendorSearch-MCP.git

If Git is not installed, download the ZIP and use local path:

claude mcp add-json "partvendor" '{"command":"uvx","args":["--from","C:\\PartVendorSearch-MCP","urlvendor-mcp-server"]}'

Other MCP Clients

The server uses STDIO transport by default, making it compatible with any MCP client that supports subprocess communication.

🛠 Available Tools

Individual Vendor Search

search_injuredgadgets

Search InjuredGadgets.com for mobile device repair parts.
Parameters:
  - query (str): Search term (e.g., "iPhone 16 Pro Max screen")
  - max_results (int): Maximum results to return (default: 20, max: 50)

search_mobilesentrix

Search MobileSentrix.com for mobile device repair parts.
Parameters:
  - query (str): Search term (e.g., "iPhone 16 screen replacement")
  - max_results (int): Maximum results to return (default: 20, max: 50)

search_wholesalegadgetparts

Search WholesaleGadgetParts.com for mobile device repair parts.
Parameters:
  - query (str): Search term (e.g., "iPhone parts wholesale")
  - max_results (int): Maximum results to return (default: 20, max: 50)

search_phonelcdparts

Search PhoneLCDParts.com for mobile device repair parts.
Parameters:
  - query (str): Search term (e.g., "iPhone 15 LCD screen")
  - max_results (int): Maximum results to return (default: 20, max: 50)

Multi-vendor Search

search_all_vendors

Search all vendors simultaneously for comprehensive results.
Parameters:
  - query (str): Search term (e.g., "iPhone 16 Pro Max screen")
  - max_results_per_vendor (int): Max results per vendor (default: 10, max: 20)

📋 Response Format

All tools return structured JSON responses:

Individual Vendor Response

{
  "vendor": "MobileSentrix",
  "query": "iPhone 16 screen",
  "total_results": 15,
  "products": [
    {
      "name": "iPhone 16 Pro Max OLED Display Assembly",
      "price": "$299.99",
      "stock": "Available",
      "url": "https://www.mobilesentrix.com/product/...",
      "brand": "Apple"
    }
  ]
}

Multi-vendor Response

{
  "query": "iPhone 16 screen",
  "total_vendors": 4,
  "total_results": 45,
  "vendors": {
    "InjuredGadgets": {
      "total_results": 12,
      "products": [...]
    },
    "MobileSentrix": {
      "total_results": 15,
      "products": [...]
    },
    "WholesaleGadgetParts": {
      "total_results": 8,
      "products": [...]
    },
    "PhoneLCDParts": {
      "total_results": 10,
      "products": [...]
    }
  }
}

🔍 Usage Examples

Search All Vendors

Ask Claude: "Search all mobile repair vendors for iPhone 16 Pro Max screen replacement parts"

Search Specific Vendor

Ask Claude: "Search MobileSentrix for Samsung Galaxy S24 battery replacement parts"

Price Comparison

Ask Claude: "Find the cheapest iPhone 15 screen across all vendors and compare prices"

Wholesale Inquiry

Ask Claude: "Search WholesaleGadgetParts for bulk iPhone repair tools and kits"

🏗 Architecture

Scraper Components

• InjuredGadgets: Uses cloudscraper to bypass Cloudflare protection
• MobileSentrix: Sophisticated session management with form-key extraction
• WholesaleGadgetParts: POST form-based search with session cookies
• PhoneLCDParts: Simple HTTP requests with BeautifulSoup parsing

MCP Integration

• FastMCP Framework: Modern Python MCP server framework
• STDIO Transport: Standard input/output communication
• Tool Registration: Automatic tool discovery and registration
• Error Handling: Graceful error handling with detailed error messages

🐛 Troubleshooting

Common Issues

Installation Issues

# Ensure you have Python 3.11+
python --version

# Update uvx
pip install --upgrade uv

Connection Issues

• Check internet connection
• Some vendors may have rate limiting
• Cloudflare protection on InjuredGadgets may occasionally block requests

Claude Desktop Not Finding Server

• Verify configuration file location
• Check that uvx is in your PATH
• Restart Claude Desktop after configuration changes

Debug Mode

Enable debug logging:

import logging
logging.basicConfig(level=logging.DEBUG)

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📜 License

This project is licensed under the MIT License - see the file for details.

⚠️ Disclaimer

This software is for educational and research purposes. Please respect the terms of service of the websites being scraped and implement appropriate rate limiting in production use. The authors are not responsible for any misuse of this software.

🔗 Links

• GitHub Repository: https://github.com/cnguyen14/PartVendorSearch-MCP
• PyPI Package: https://pypi.org/project/urlvendor-mcp-server/
• FastMCP Documentation: https://gofastmcp.com/
• Model Context Protocol: https://modelcontextprotocol.io/

Built with ❤️ using FastMCP and Python