CoolPC MCP Server

Consulte preços de componentes de computador no site CoolPC de Taiwan para gerar cotações de preço assistidas por IA.

GitHub
23
Experimente este MCPPatrocinado

Documentação

CoolPC MCP Server

Um servidor baseado no Model Context Protocol (MCP) que fornece funcionalidade de consulta de preços de componentes de computador da loja taiwanesa 原價屋 (CoolPC), permitindo que clientes MCP como o Claude Desktop gerem cotações de computador com assistência de IA.

Funcionalidades

  • 🔍 Busca Inteligente: suporta busca por palavras-chave, categoria e faixa de preço
  • 📊 Análise de Produtos: fornece comparação de especificações e análise de preços
  • 💰 Geração de Cotações: gera automaticamente cotações de configuração de computador com base nas necessidades
  • 🔥 Marcadores em Tempo Real: exibe marcadores como produtos mais vendidos, produtos com desconto e ofertas por tempo limitado
  • 🏷️ Navegação por Categoria: informações completas de categorias de produtos e estatísticas

Estrutura do Projeto

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                  # 說明文件

Início Rápido

1. Requisitos de Ambiente

  • Python 3.x (para análise de dados)
  • Node.js 18+ (para o MCP Server)
  • Claude Desktop (como cliente MCP)

2. Instalação de Dependências

# 安裝 Node.js 相依性
npm install

3. Gerar product.json

Obtenha os dados mais recentes do site da CoolPC e gere o arquivo de dados de produtos:

# 方法一：直接下載最新資料並解析 (推薦)
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. Compilar o MCP Server

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

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

Configuração do Claude Desktop

Configure o MCP Server no Claude Desktop para que o Claude possa usar a funcionalidade de consulta de componentes de computador.

Etapas de Configuração

  1. Abra o arquivo de configuração do Claude Desktop

    Encontre o local do arquivo de configuração do Claude Desktop:

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

  2. Adicione a configuração do MCP Server

    Adicione a seguinte configuração ao arquivo de configuração:

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

    Substitua /path/to/coolpc-mcp-server pelo caminho real do projeto

  3. Reinicie o Claude Desktop

    Após salvar o arquivo de configuração, reinicie o Claude Desktop para que as configurações entrem em vigor.

Exemplos de Uso

Após a configuração, você pode usar os seguintes comandos no 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 晶片組主機板

Ferramentas Disponíveis

O MCP Server fornece as seguintes ferramentas para uso do Claude:

search_products

Busca produtos, com suporte a filtros por palavra-chave, categoria e faixa de preço

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

get_product_by_model

Obtém informações de um produto específico pelo modelo

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

list_categories

Lista todas as categorias de produtos e informações estatísticas

list_categories()

get_category_products

Obtém todos os produtos de uma categoria específica

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

search_cpu

Busca especificamente processadores CPU, com suporte a filtros por soquete, número de núcleos e ordenação por preço

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

search_gpu

Busca especificamente placas de vídeo, com suporte a filtros por modelo de chip, capacidade de memória e ordenação por preço

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 especificamente memórias RAM, com suporte a filtros por tipo, capacidade, frequência e ordenação por preço

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 especificamente SSDs, com suporte a filtros por interface, capacidade e ordenação por preço

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 especificamente placas-mãe, com suporte a filtros por soquete, chipset, formato e ordenação por preço

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)
})

Guia de Desenvolvimento

Atualizando Dados de Produtos

Atualize regularmente os dados de produtos para garantir que preços e informações de estoque estejam precisos:

# 方法一：直接下載最新資料 (推薦)
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 Desenvolvimento

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

Depuração

Verifique o status da conexão MCP do Claude Desktop:

  1. Abra o Claude Desktop
  2. Verifique se o ícone 🔌 aparece no canto inferior esquerdo
  3. Clique para ver o status da conexão do MCP Server

Solução de Problemas

Problemas Comuns

P: O Claude Desktop não consegue se conectar ao MCP Server

  • Verifique se o caminho do arquivo de configuração está correto
  • Confirme se o Node.js e as dependências estão instalados corretamente
  • Verifique se o arquivo product.json existe

P: Os resultados da busca estão vazios

  • Confirme se o product.json contém dados
  • Verifique se a palavra-chave de busca está correta
  • Tente usar diferentes critérios de busca

P: Os dados dos produtos estão desatualizados

  • Obtenha novamente os dados HTML do site da CoolPC
  • Execute o parser para atualizar o product.json
  • Reinicie o MCP Server

Verificação de Logs

# 檢查 MCP Server 輸出
npm run dev

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

Termos de Licença

Este projeto é apenas para fins de aprendizado e pesquisa. Ao usá-lo, respeite os termos de uso do site da CoolPC.

Contribuição

Sinta-se à vontade para enviar Issues e Pull Requests para melhorar este projeto.

Nota: Esta ferramenta fornece apenas referência de preços. Os preços reais devem ser verificados no site oficial da CoolPC.