coolpc-mcp-server - 支持台湾原价屋配件查价与报价单生成的MCP协议服务器

探索

Coolpc MCP Server

一个基于MCP协议的服务器，提供台湾原价屋电脑零组件价格查询和自动生成电脑配置报价单的功能

电子商务与零售开发者工具 #电脑报价 #零组件查询 #价格分析 #自动配置 .TypeScript

评分 : 2.5分

下载量 : 9.0K

更新时间 : 2025-07-24

打开站点

什么是CoolPC MCP Server？

CoolPC MCP Server是一个基于Model Context Protocol (MCP) 的服务器，允许用户通过Claude Desktop等MCP客户端查询台湾原价屋（CoolPC）网站上的电脑零组件价格信息。该服务器可以生成电脑配置报价单，并支持智能搜索和产品分析。

如何使用CoolPC MCP Server？

要使用CoolPC MCP Server，您需要先安装Node.js和Python环境，然后从原价屋网站获取最新产品数据。接着运行MCP服务器，最后在Claude Desktop中配置服务器连接。

适用场景

适用于游戏玩家、IT技术人员或普通用户，帮助他们快速查找电脑组件价格并生成配置报价单。

主要功能

智能搜索

支持关键字、分类和价格范围搜索，帮助用户快速找到所需产品。

产品分析

提供产品规格比较和价格分析，便于用户做出最佳选择。

报价生成

根据用户需求自动生成电脑配置报价单，节省时间和精力。

实时标记

显示热销商品、降价商品和限时优惠等标记，方便用户关注热门产品。

分类浏览

提供完整的分类和统计信息，让用户更轻松地浏览产品。

优势

支持多种搜索方式，提高查询效率

提供详细的产品分析和报价生成功能

兼容Claude Desktop等MCP客户端，扩展性强

局限性

依赖于原价屋网站的数据，无法独立更新产品信息

需要一定的技术基础进行配置和维护

部分高级功能可能需要额外开发

如何使用

安装依赖

确保您的系统已安装Node.js 18+ 和 Python 3.x。

获取产品数据

使用Python脚本从原价屋网站下载并解析最新产品数据。

启动MCP服务器

在开发模式下运行MCP服务器以测试功能。

配置Claude Desktop

在Claude Desktop的配置文件中添加MCP服务器的路径。

使用案例

查找高性能游戏电脑配置

用户希望找到适合运行4K分辨率3A大作的游戏电脑配置。

查找特定规格的内存

用户需要查找DDR5 32GB的内存条。

比较显卡性能

用户想了解NVIDIA RTX 4070和RTX 4060的规格和价格差异。

常见问题

Claude Desktop无法连接到MCP服务器怎么办？

为什么搜索结果为空？

如何更新产品数据？

MCP服务器的开发模式是什么？

🚀 CoolPC MCP Server

CoolPC MCP Server 是一個基於 Model Context Protocol (MCP) 的伺服器，可提供台灣原價屋 (CoolPC) 電腦零組件價格查詢功能。透過此伺服器，Claude Desktop 等 MCP 客戶端能夠借助 AI 協助生成電腦報價單，極大地方便了用戶。

✨ 主要特性

🔍 智能搜尋：支援透過關鍵字、分類、價格範圍進行搜尋，讓用戶快速定位所需產品。
📊 產品分析：提供產品規格比較和價格分析，幫助用戶做出更明智的購買決策。
💰 報價生成：根據用戶需求自動生成電腦配置報價單，節省時間和精力。
🔥 即時標記：顯示熱銷商品、降價商品、限時優惠等標記，使用戶及時掌握商品動態。
🏷️ 分類瀏覽：提供完整的產品分類和統計資訊，方便用戶瀏覽和選擇。

📁 專案結構

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

🚀 快速開始

1. 環境需求

Python 3.x：用於資料解析。
Node.js 18+：用於 MCP Server。
Claude Desktop：作為 MCP 客戶端。

2. 安裝相依性

# 安裝 Node.js 相依性
npm install

3. 產生 product.json

從原價屋網站取得最新資料並產生產品資料檔，有以下兩種方法：

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

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

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

💻 使用示例

Claude Desktop 設定

在 Claude Desktop 中設定 MCP Server，讓 Claude 能夠使用電腦零組件查詢功能。

設定步驟

開啟 Claude Desktop 設定檔
- macOS：設定檔位置為 ~/Library/Application Support/Claude/claude_desktop_config.json。
- Windows：設定檔位置為 %APPDATA%\\Claude\\claude_desktop_config.json。
新增 MCP Server 設定 在設定檔中新增以下設定：

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

⚠️ 重要提示：請將 /path/to/coolpc-mcp-server 替換為專案的實際路徑。

重新啟動 Claude Desktop 儲存設定檔後，重新啟動 Claude Desktop 讓設定生效。

使用範例

設定完成後，您可以在 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 晶片組主機板

可用工具

MCP Server 提供以下工具供 Claude 使用：

`search_products`

搜尋產品，支援關鍵字、分類、價格範圍篩選。

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

`get_product_by_model`

根據型號取得特定產品資訊。

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

`list_categories`

列出所有產品分類及統計資訊。

list_categories()

`get_category_products`

取得特定分類的所有產品。

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

`search_cpu`

專門搜尋 CPU 處理器，支援腳位、核心數篩選和價格排序。

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

`search_gpu`

專門搜尋顯示卡，支援晶片型號、記憶體容量篩選和價格排序。

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`

專門搜尋記憶體，支援類型、容量、頻率篩選和價格排序。

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`

專門搜尋固態硬碟，支援介面、容量篩選和價格排序。

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

`search_motherboard`

專門搜尋主機板，支援腳位、晶片組、尺寸規格篩選和價格排序。

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

🛠️ 開發指南

更新產品資料

定期更新產品資料以確保價格和庫存資訊準確：

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

開發模式

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

除錯

檢查 Claude Desktop 的 MCP 連線狀態：

開啟 Claude Desktop。
檢查左下角是否顯示 🔌 圖示。
點擊查看 MCP Server 連線狀態。

❓ 故障排除

常見問題

Q: Claude Desktop 無法連接到 MCP Server

檢查設定檔路徑是否正確。
確認 Node.js 和相依性已正確安裝。
檢查 product.json 檔案是否存在。

Q: 搜尋結果為空

確認 product.json 包含資料。
檢查搜尋關鍵字是否正確。
嘗試使用不同的搜尋條件。

Q: 產品資料過舊

重新從原價屋網站取得 HTML 資料。
執行解析器更新 product.json。
重新啟動 MCP Server。

日誌檢查

# 檢查 MCP Server 輸出
npm run dev

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

📄 授權條款

本專案僅供學習和研究用途。使用時請遵守原價屋網站的使用條款。

👥 貢獻

歡迎提交 Issue 和 Pull Request 來改善這個專案。

⚠️ 重要提示：本工具僅提供價格參考，實際價格請以原價屋官網為準。

search_products

General search across all computer components. Use this for broad searches or when component type is uncertain. For specific components, use dedicated search tools (search_cpu, search_gpu, etc.)

参数

keyword : string*

描述

Search keyword - can be brand name (Intel, AMD, NVIDIA), model number, or specifications. Examples: 'Intel', 'RTX', '32GB', 'B650'

参数

category : string*

描述

Filter by product category. Examples: 'CPU', 'GPU', 'RAM', 'SSD', 'MB' (motherboard). Leave empty to search all categories

参数

min_price : number*

描述

Minimum price in TWD. Example: 5000 for products above NT$5,000

参数

max_price : number*

描述

Maximum price in TWD. Example: 20000 for products under NT$20,000

参数

limit : number*

描述

Maximum number of results to return. Valid range: 1-100, default: 10

search_cpu

Specialized CPU/processor search tool. Find CPUs by socket compatibility, core count, and sort by price. Best for building compatible systems or finding CPUs with specific performance characteristics.

参数

socket : string*

描述

CPU socket type for motherboard compatibility. Intel examples: '1700' (12-14th gen), '1851' (Core Ultra). AMD examples: 'AM5' (Ryzen 7000/8000/9000), 'AM4' (older Ryzen)

参数

cores : number*

描述

Number of physical CPU cores (not threads). Common values: 4, 6, 8, 10, 12, 16, 24, 32. Example: 6 for hex-core CPUs

参数

sort_by : string*

描述

Price sorting order. 'price_asc' = cheapest first (budget builds), 'price_desc' = most expensive first (high-end builds)

参数

limit : number*

描述

Maximum results to return. Valid range: 1-50, default: 10. Use higher values to see more options

search_gpu

Specialized graphics card (VGA) search tool. Find GPUs by chipset model, VRAM capacity, and price. Perfect for gaming builds, content creation, or AI workloads.

参数

chipset : string*

描述

GPU chipset model. NVIDIA examples: 'RTX 4090', 'RTX 4070', 'RTX 4060', 'RTX 3060'. AMD examples: 'RX 7900', 'RX 7600'. Intel: 'Arc B580', 'Arc B570'

参数

memory : number*

描述

Video memory (VRAM) capacity in GB. Common values: 8, 12, 16, 24. Example: 12 for 12GB VRAM cards suitable for 1440p gaming

参数

sort_by : string*

描述

Price sorting order. 'price_asc' = cheapest first (value gaming), 'price_desc' = most expensive first (premium performance)

参数

limit : number*

描述

Maximum results to return. Valid range: 1-50, default: 10. Higher values show more brand/model variations

search_ram

Specialized memory (RAM) search tool. Find desktop or laptop memory by DDR generation, total capacity, speed, and price. Essential for system upgrades or new builds.

参数

type : string*

描述

RAM generation/type. Options: 'DDR4' (older systems, cheaper), 'DDR5' (newest, faster). Must match motherboard compatibility

参数

capacity : number*

描述

Total memory capacity in GB. Common values: 8, 16, 32, 64. Example: 32 for 32GB total (can be 2x16GB or 4x8GB kit)

参数

frequency : number*

描述

Memory speed in MHz. DDR4 common: 3200, 3600. DDR5 common: 4800, 5600, 6000. Higher = better performance

参数

sort_by : string*

描述

Price sorting order. 'price_asc' = budget options first, 'price_desc' = premium/performance kits first

参数

limit : number*

描述

Maximum results to return. Valid range: 1-50, default: 10. More results = more brand choices

search_ssd

Specialized SSD/solid-state drive search tool. Find storage drives by interface type, capacity, and price. Covers M.2 NVMe, SATA, and PCIe drives for OS and data storage.

参数

interface : string*

描述

Storage interface/connection type. Options: 'M.2' (compact, fast), 'NVMe' (PCIe-based, fastest), 'SATA' (2.5", compatible), 'PCIe' (add-in card). 'M.2 NVMe' for modern builds

参数

capacity : number*

描述

Storage capacity in GB. Common values: 256, 512, 1000 (1TB), 2000 (2TB), 4000 (4TB). Example: 1000 for 1TB drives

参数

sort_by : string*

描述

Price sorting order. 'price_asc' = value drives first, 'price_desc' = premium/high-performance drives first

参数

limit : number*

描述

Maximum results to return. Valid range: 1-50, default: 10. More results show various brands/speeds

search_motherboard

Specialized motherboard (MB/mainboard) search tool. Find motherboards by CPU socket, chipset, and size. Critical for system compatibility - must match CPU socket and case size.

参数

socket : string*

描述

CPU socket - MUST match your CPU. Intel: '1700' (12-14th gen), '1851' (Core Ultra). AMD: 'AM5' (Ryzen 7000+), 'AM4' (older Ryzen). Check CPU specs first!

参数

chipset : string*

描述

Motherboard chipset determines features. Intel: 'Z790' (high-end), 'B760' (mainstream), 'H610' (budget). AMD: 'X670' (high-end), 'B650' (mainstream), 'A620' (budget)

参数

form_factor : string*

描述

Physical size - must fit your case. 'ATX' (full size, most expansion), 'mATX' or 'MATX' (compact, good balance), 'ITX' (mini, small builds)

参数

sort_by : string*

描述

Price sorting order. 'price_asc' = budget boards first, 'price_desc' = feature-rich boards first

参数

limit : number*

描述

Maximum results to return. Valid range: 1-50, default: 10. More results = more brand/feature options

get_product_by_model

Get detailed specifications and pricing for a specific product by exact model number. Use when you know the exact product model and need full details including specs, current price, and availability markers.

参数

model : string*

描述

Exact product model number (case-insensitive). Examples: 'i5-14400F', 'RTX 4060', 'B650M-PLUS', 'WD_BLACK SN770'. Must match exactly as listed

list_categories

Get a complete list of all product categories with statistics. Shows category names, product counts, and special markers (hot items, discounts). Useful for browsing available product types or understanding the catalog structure.

get_category_products

Browse all products within a specific category. Useful for exploring all options in a product type when you don't have specific search criteria. Returns products with full details including prices and specifications.

参数

category_id : string*

描述

Category ID from list_categories. Examples: 'cat_cpu' for processors, 'cat_vga' for graphics cards. Use list_categories first to get valid IDs

参数

subcategory_name : string*

描述

Filter by specific subcategory name. Example: 'Intel Raptor Lake-s 14代1700 腳位' for 14th gen Intel CPUs. Optional - omit to see all subcategories

参数

limit : number*

描述

Maximum products to return. Valid range: 1-100, default: 20. Higher values to see more products in the category