技术文档摘要

CoolPC MCP Server

基于模型上下文协议（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

2. 新增 MCP Server 设置

   在配置文件中添加以下设置：

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

   请将 /path/to/coolpc-mcp-server 替换为项目的实际路径

3. 重启 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在线状态：

1. 打开 Claude Desktop
2. 检查左下角是否显示 🔌 图标
3. 点击查看 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 来改进此项目。

---

注意此工具仅提供价格参考，请参阅原价官网的实际价格。