Atlas / MCP servers / shyuan / CoolPC

CoolPCSAFE

mcp/shyuan/coolpc

利用「原價屋」估價資料作為生成電腦設備估價單的 MCP Server

Verdict
SAFE
Grade
B
Trust score
89 /100
Exposed tools
9 9r · 0w · 0d
Transport
stdio
License
MIT
Stars
24
01

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 能夠使用電腦零組件查詢功能。

設定步驟

  1. 開啟 Claude Desktop 設定檔

找到 Claude Desktop 的設定檔位置:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\\Claude\\claude_desktop_config.json
  1. 新增 MCP Server 設定

在設定檔中新增以下設定:

{
"mcpServers": {
"coolpc": {
"command": "node",
"args": ["/path/to/coolpc-mcp-server/build/index.js"],
"env": {}
}
}
}
請將 /path/to/coolpc-mcp-server 替換為專案的實際路徑
  1. 重新啟動 Claude Desktop

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

使用範例

設定完成後,您可以在 Claude Desktop 中使用以下指令:

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

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

請推薦一
Read from source at commit cd3209b088bbOBSERVED · 2026-10-10
02

Connect

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-code
claude mcp add coolpc-mcp-server -- npx -y [email protected]
claude-desktop
{
  "mcpServers": {
    "coolpc-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ]
    }
  }
}
03

Exposed tools (9)

9 read · 0 write · 0 destructive.

ToolRiskDescription
get_category_productsreadBrowse all products within a specific category. Useful for exploring all options in a product type when you don
get_product_by_modelreadGet 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_categoriesreadGet 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_cpureadSpecialized 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_gpureadSpecialized graphics card (VGA) search tool. Find GPUs by chipset model, VRAM capacity, and price. Perfect for gaming builds, content creation, or AI workloads.
search_motherboardreadSpecialized 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_productsreadGeneral 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_ramreadSpecialized 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_ssdreadSpecialized 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.
04

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.

LayerWhat it checksResult
L0Provenance & inventoryPASS
L1Static analysis of the codePASS
L2Instruction surface (what it tells the agent)PASS
L3Class-specific surfacePASS
L4Behavioural (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)

LOWSupply chain · supply.unpinned · CWE-829, CWE-1357
package.json
@modelcontextprotocol/sdk, @types/node, tsx, typescript
Why it matters. 4 dependency range(s) float
Fix. pin exact versions or ship a lockfile
INFOInventory / provenance · inv.oversize · CWE-1104
product-sample.json
product-sample.json
Why it matters. 4591493 bytes not read

Gates applied: no_behavioural_pass.

Audited 2026-10-10 · audit v0.4.1 · source sha cd3209b088bbfull audit observations/trust-audit/mcp-server/shyuan__coolpc.json · Report an issue / request a re-scan
05

Audit history

Every audit this server has had. A grade with a past is a grade somebody is still checking.

DateSourceVerdictGradeScoreChange
2026-10-10cd3209b088bbSAFEB89first audit
06

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.

Advertisement