CoolPC MCP Server

Consulta los precios de componentes de computadora en el sitio web CoolPC de Taiwán para generar cotizaciones de precios asistidas por IA.

GitHub
22
Prueba este MCPPatrocinado

Documentación

CoolPC MCP Server

Un servidor basado en el Protocolo de Contexto de Modelos (MCP) que proporciona funciones de consulta de precios de componentes de computadoras de CoolPC (原價屋) en Taiwán, permitiendo que clientes MCP como Claude Desktop generen cotizaciones de computadoras con asistencia de IA.

Características

  • 🔍 Búsqueda inteligente: Compatible con búsqueda por palabras clave, categoría y rango de precios
  • 📊 Análisis de productos: Proporciona comparación de especificaciones y análisis de precios
  • 💰 Generación de cotizaciones: Genera automáticamente cotizaciones de configuraciones de computadoras según las necesidades
  • 🔥 Marcadores en tiempo real: Muestra marcadores como productos populares, productos con descuento y ofertas por tiempo limitado
  • 🏷️ Navegación por categorías: Información completa de categorías de productos y estadísticas

Estructura del proyecto

coolpc-mcp-server/
├── coolpc_parser.py             # Python 解析器
├── evaluate.html               # 範例 HTML 資料
├── product-sample.json         # 範例產品資料
├── src/
│   └── index.ts               # MCP Server 主程式
├── package.json               # Node.js 相依性
├── tsconfig.json              # TypeScript 設定
└── README.md                  # 說明文件

Inicio rápido

1. Requisitos del entorno

  • Python 3.x (para análisis de datos)
  • Node.js 18+ (para el servidor MCP)
  • Claude Desktop (como cliente MCP)

2. Instalación de dependencias

# 安裝 Node.js 相依性
npm install

3. Generar product.json

Obtenga los datos más recientes del sitio web de CoolPC y genere el archivo de datos de productos:

# 方法一：直接下載最新資料並解析 (推薦)
python3 coolpc_parser.py --download --json product.json

# 方法二：使用本地 HTML 檔案
# 1. 開啟瀏覽器到 https://www.coolpc.com.tw/evaluate.php
# 2. 另存網頁為 evaluate.html
# 3. 執行解析器
python3 coolpc_parser.py evaluate.html --json product.json

4. Construir el servidor MCP

# 開發模式 (即時編譯)
npm run dev

# 或建置生產版本
npm run build
npm start

Configuración de Claude Desktop

Configure el servidor MCP en Claude Desktop para que Claude pueda usar las funciones de consulta de componentes de computadoras.

Pasos de configuración

  1. Abra el archivo de configuración de Claude Desktop

    Encuentre la ubicación del archivo de configuración de Claude Desktop:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\\Claude\\claude_desktop_config.json

  2. Agregue la configuración del servidor MCP

    Agregue la siguiente configuración al archivo de configuración:

    {
  "mcpServers": {
    "coolpc": {
      "command": "node",
      "args": ["/path/to/coolpc-mcp-server/build/index.js"],
      "env": {}
    }
  }
}

    Reemplace /path/to/coolpc-mcp-server con la ruta real del proyecto

  3. Reinicie Claude Desktop

    Después de guardar el archivo de configuración, reinicie Claude Desktop para que la configuración surta efecto.

Ejemplo de uso

Después de la configuración, puede usar los siguientes comandos en Claude Desktop:

請幫我查詢 Intel CPU 的價格範圍

幫我配電腦菜單，能順跑 4K 解析度 3A 大作，並且 CP 值要非常高，儘可能節省預算

請推薦一套預算 3 萬元的遊戲電腦配置

整理一套預算 15000 元內的準系統文書機

比較 NVIDIA RTX 4070 和 RTX 4060 的規格和價格

列出所有主機板的分類和數量

查詢 AM5 腳位的 CPU，價格由低到高排序

找出 6 核心的處理器

搜尋 RTX 4060 顯示卡，價格由低到高

找出 DDR5 32GB 的記憶體

查詢 1TB 的 M.2 SSD

找 AM5 腳位的 B650 晶片組主機板

Herramientas disponibles

El servidor MCP proporciona las siguientes herramientas para que Claude las use:

search_products

Busca productos, compatible con filtros por palabra clave, categoría y rango de precios

search_products({
  keyword?: string,    // 搜尋關鍵字
  category?: string,   // 產品分類
  minPrice?: number,   // 最低價格
  maxPrice?: number    // 最高價格
})

get_product_by_model

Obtiene información específica de un producto según el modelo

get_product_by_model({
  model: string       // 產品型號
})

list_categories

Lista todas las categorías de productos e información estadística

list_categories()

get_category_products

Obtiene todos los productos de una categoría específica

get_category_products({
  category: string    // 分類名稱
})

search_cpu

Busca específicamente procesadores CPU, compatible con filtros por zócalo, número de núcleos y ordenamiento por precio

search_cpu({
  socket?: string,     // CPU 腳位 (如 'AM5', '1700', '1851', 'AM4')
  cores?: number,      // 核心數量
  sort_by?: string,    // 排序方式 ('price_asc' | 'price_desc')
  limit?: number       // 結果數量限制 (預設: 10)
})

search_gpu

Busca específicamente tarjetas gráficas, compatible con filtros por modelo de chip, capacidad de memoria y ordenamiento por precio

search_gpu({
  chipset?: string,    // GPU 晶片 (如 'RTX 4060', 'RTX 4070', 'RX 7600')
  memory?: number,     // 記憶體容量 (GB)
  sort_by?: string,    // 排序方式 ('price_asc' | 'price_desc')
  limit?: number       // 結果數量限制 (預設: 10)
})

search_ram

Busca específicamente memoria RAM, compatible con filtros por tipo, capacidad, frecuencia y ordenamiento por precio

search_ram({
  type?: string,       // 記憶體類型 (如 'DDR4', 'DDR5')
  capacity?: number,   // 總容量 (GB)
  frequency?: number,  // 頻率 (MHz，如 3200, 4800, 5600)
  sort_by?: string,    // 排序方式 ('price_asc' | 'price_desc')
  limit?: number       // 結果數量限制 (預設: 10)
})

search_ssd

Busca específicamente unidades de estado sólido (SSD), compatible con filtros por interfaz, capacidad y ordenamiento por precio

search_ssd({
  interface?: string,  // 介面類型 (如 'M.2', 'SATA', 'NVMe', 'PCIe')
  capacity?: number,   // 容量 (GB)
  sort_by?: string,    // 排序方式 ('price_asc' | 'price_desc')
  limit?: number       // 結果數量限制 (預設: 10)
})

search_motherboard

Busca específicamente placas base, compatible con filtros por zócalo, chipset, factor de forma y ordenamiento por precio

search_motherboard({
  socket?: string,     // CPU 腳位 (如 'AM5', '1700', '1851', 'AM4')
  chipset?: string,    // 晶片組 (如 'B650', 'X670', 'Z790', 'B760')
  form_factor?: string,// 尺寸規格 (如 'ATX', 'mATX', 'ITX')
  sort_by?: string,    // 排序方式 ('price_asc' | 'price_desc')
  limit?: number       // 結果數量限制 (預設: 10)
})

Guía de desarrollo

Actualizar datos de productos

Actualice periódicamente los datos de productos para garantizar la precisión de precios e inventario:

# 方法一：直接下載最新資料 (推薦)
python3 coolpc_parser.py --download --json product.json

# 方法二：手動下載 HTML 檔案
# 1. 從 https://www.coolpc.com.tw/evaluate.php 下載最新 HTML
# 2. 解析資料
python3 coolpc_parser.py evaluate.html --json product.json

# 重新建置 MCP Server
npm run build

Modo de desarrollo

# 開發模式 (自動重載)
npm run dev

Depuración

Verifique el estado de conexión MCP de Claude Desktop:

  1. Abra Claude Desktop
  2. Verifique si el ícono 🔌 aparece en la esquina inferior izquierda
  3. Haga clic para ver el estado de conexión del servidor MCP

Solución de problemas

Problemas comunes

P: Claude Desktop no puede conectarse al servidor MCP

  • Verifique que la ruta del archivo de configuración sea correcta
  • Confirme que Node.js y las dependencias estén instalados correctamente
  • Verifique que el archivo product.json exista

P: Los resultados de búsqueda están vacíos

  • Confirme que product.json contenga datos
  • Verifique que la palabra clave de búsqueda sea correcta
  • Intente usar diferentes criterios de búsqueda

P: Los datos de productos están desactualizados

  • Vuelva a obtener los datos HTML del sitio web de CoolPC
  • Ejecute el analizador para actualizar product.json
  • Reinicie el servidor MCP

Verificación de registros

# 檢查 MCP Server 輸出
npm run dev

# 檢查解析器輸出
python3 coolpc_parser.py evaluate.html --summary

Términos de licencia

Este proyecto es solo para fines de aprendizaje e investigación. Al usarlo, cumpla con los términos de uso del sitio web de CoolPC.

Contribuciones

Las contribuciones con Issues y Pull Requests son bienvenidas para mejorar este proyecto.

Nota: Esta herramienta solo proporciona referencia de precios; los precios reales están sujetos al sitio web oficial de CoolPC.