CoolPCSAFE
利用「原價屋」估價資料作為生成電腦設備估價單的 MCP Server
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
一個基於 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 設定檔
找到 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 值要非常高,儘可能節省預算 請推薦一
cd3209b088bbOBSERVED · 2026-10-10Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.
claude mcp add coolpc-mcp-server -- npx -y [email protected]
{
"mcpServers": {
"coolpc-mcp-server": {
"command": "npx",
"args": [
"-y",
"[email protected]"
]
}
}
}Exposed tools (9)
9 read · 0 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
get_category_products | read | Browse all products within a specific category. Useful for exploring all options in a product type when you don |
get_product_by_model | read | 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. |
list_categories | read | 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. |
search_cpu | read | 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. |
search_gpu | read | Specialized graphics card (VGA) search tool. Find GPUs by chipset model, VRAM capacity, and price. Perfect for gaming builds, content creation, or AI workloads. |
search_motherboard | read | 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. |
search_products | read | 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.) |
search_ram | read | 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. |
search_ssd | read | 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. |
Trust audit
SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- none-observed
- Network
- declared (3 observation(s))
- Shell
- none-observed
- Dependencies
- not all pinned
- Secrets in source
- none-found
Findings (2)
@modelcontextprotocol/sdk, @types/node, tsx, typescript
product-sample.json
Gates applied: no_behavioural_pass.
cd3209b088bbfull audit observations/trust-audit/mcp-server/shyuan__coolpc.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-10 | cd3209b088bb | SAFE | B | 89 | first audit |
Questions
What is the CoolPC MCP server?
利用「原價屋」估價資料作為生成電腦設備估價單的 MCP Server
What tools does CoolPC expose?
9 in total: 9 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is CoolPC safe to connect to an agent?
The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B.
What credentials does CoolPC need?
No credential environment variables were found in its source, so it appears to need none.
How does CoolPC run?
It speaks stdio, so it runs as a local process your client starts. It is published on npm as coolpc-mcp-server at 1.1.0.
How current is this page?
The grade is for one exact copy of the source (cd3209b088bb), read on 2026-10-10. The repository is watched and re-audited when it changes.