Partvendorsearch MCP

URLVendor MCP服务器

一种模型上下文协议（MCP）服务器，通过人工智能驱动的搜索工具提供对移动设备维修零件供应商的访问。搜索范围 受伤Gadgets, MobileSentrix 公司, 批发配件，以及 电话LCD部件 同时或单独。

🚀 特性

• 多供应商搜索：同时查询4家主要移动维修零件供应商
• 单个供应商工具：当你知道在哪里寻找时，搜索特定的供应商
• STDIO传输：与Claude Desktop和其他MCP客户端兼容
• uvx支持：通过以下方式易于安装和执行 uvx
• 结构化输出：与产品详细信息一致的JSON响应
• 错误处理：强大的错误处理和回退机制

🛠 支持的供应商

📦 安装

使用uvx（推荐）

# Install and run directly
uvx urlvendor-mcp-server

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

使用pip

# Install
pip install urlvendor-mcp-server

# Run
urlvendor-mcp-server

来源

# 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

🔧 配置

克劳德桌面

添加到您的Claude Desktop配置(~/Library/Application Support/Claude/claude_desktop_config.json 在 macOS 上：

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

克劳德代码

使用内置的MCP管理添加到Claude Code中：

# 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

如果未安装Git，下载ZIP并使用本地路径：

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

其他MCP客户端

默认情况下，服务器使用STDIO传输，使其与支持子进程通信的任何MCP客户端兼容。

🛠 可用工具

个人供应商搜索

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)

多供应商搜索

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)

📋 响应格式

所有工具都返回结构化的JSON响应：

单个供应商响应

{
  "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"
    }
  ]
}

多供应商响应

{
  "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": [...]
    }
  }
}

🔍 使用示例

搜索所有供应商

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

搜索特定供应商

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

价格比较

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

批发询价

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

🏗 建筑

刮板组件

• 受伤Gadgets：用途 cloudscraper 绕过Cloudflare保护
• MobileSentrix 公司：具有表单密钥提取功能的复杂会话管理
• 批发配件：使用会话Cookie进行POST表单搜索
• 电话LCD部件：使用BeautifulSoup解析的简单HTTP请求

MCP集成

• FastMCP框架：现代Python MCP服务器框架
• STDIO传输：标准输入/输出通信
• 工具注册：自动工具发现和注册
• 错误处理：优雅的错误处理，包含详细的错误消息

🐛 故障排除

常见问题

安装问题

# Ensure you have Python 3.11+
python --version

# Update uvx
pip install --upgrade uv

连接问题

• 检查互联网连接
• 一些供应商可能有费率限制
• Cloudflare对InjuredGadgets的保护可能偶尔会阻止请求

克劳德桌面找不到服务器

• 验证配置文件位置
• 检查uvx是否在您的PATH中
• 配置更改后重新启动Claude Desktop

调试模式

启用调试日志记录：

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

🤝 贡献

欢迎投稿！请随时提交拉取请求。

1. 分叉存储库
2. 创建要素分支(git checkout -b feature/amazing-feature)
3. 提交您的更改(git commit -m 'Add amazing feature')
4. 推到分支(git push origin feature/amazing-feature)
5. 打开拉取请求

📜 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

⚠️ 免责声明

该软件用于教育和研究目的。请尊重被抓取网站的服务条款，并在生产使用中实施适当的费率限制。作者不对任何滥用此软件的行为负责。

🔗 链接

• GitHub存储库: https://github.com/cnguyen14/PartVendorSearch-MCP
• PyPI包: https://pypi.org/project/urlvendor-mcp-server/
• FastMCP文档: https://gofastmcp.com/
• 模型上下文协议: https://modelcontextprotocol.io/

______________________________________________________________________

内置于❤️ 使用FastMCP和Python