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 の生成

原價屋のウェブサイトから最新のデータを取得し、製品データファイルを生成します。

# 方法 1: 最新のデータを直接ダウンロードして解析する (推奨)
python3 coolpc_parser.py --download --json product.json

# 方法 2: ローカルの 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 ゲームを快適にプレイでき、コスパが非常に高く、予算を節約できるコンピューターの見積もりを作成してください。

予算 3 万円のゲーム用コンピューターの構成を推薦してください。

予算 15000 円以内の準システム文書機をまとめてください。

NVIDIA RTX 4070 と RTX 4060 の仕様と価格を比較してください。

すべてのマザーボードの分類と数量をリストアップしてください。

AM5 ソケットの CPU を価格の安い順に検索してください。

6 コアのプロセッサーを見つけてください。

RTX 4060 グラフィックカードを価格の安い順に検索してください。

DDR5 32GB のメモリを見つけてください。

1TB の M.2 SSD を検索してください。

AM5 ソケットの B650 チップセットのマザーボードを見つけてください。

📚 ドキュメント

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

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

🔧 開発ガイド

製品データの更新

定期的に製品データを更新して、価格と在庫情報の正確性を確保します。

# 方法 1: 最新のデータを直接ダウンロードする (推奨)
python3 coolpc_parser.py --download --json product.json

# 方法 2: 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 の提出を歓迎します。

⚠️ 重要提示

このツールは価格の参考のみを提供します。実際の価格は原價屋の公式ウェブサイトを参照してください。