Pc Hardware MCP

🚀 Printer MCP Server

このPrinter MCP Serverは、総合的なModel Context Protocol (MCP) サーバーで、販売チームとサービスチームにエンタープライズプリンターの情報を提供します。主要なエンタープライズプリンターブランドの詳細な仕様、価格、トラブルシューティング、セットアップ情報にアクセスできます。

✨ 主な機能

対応メーカー

• HP (ヒューレット・パッカード)
• Canon
• Kyocera
• Konica Minolta
• Sharp
• Lexmark
• Ricoh
• Brother
• Epson

10のインテリジェントツール

このサーバーは、販売チームとサービスチーム向けの専用ツールを提供します。

販売チーム用ツール

1. printer_search - 仕様、予算、機能、またはキーワードでプリンターを検索します。
2. printer_get_details - 仕様、価格、機能を含む完全なモデル情報を取得します。
3. printer_compare - 複数のモデルを並べて比較します。
4. printer_calculate_tco - 経時的な総所有コスト (TCO) 分析を行います。
5. printer_find_consumables - パーツ番号とコストを含む互換性のあるトナー/消耗品を見つけます。
6. printer_recommend - ビジネスニーズに基づくAIによる推薦を取得します。
7. printer_get_stats - データベースのカバレッジと統計情報を取得します。

サービスチーム用ツール

1. printer_search - 仕様でプリンターを検索します。
2. printer_get_details - 完全なモデルと技術情報を取得します。
3. printer_troubleshoot - エラーコードの処理と問題解決を行います。
4. printer_setup - モデルとメーカー別のセットアップ手順を取得します。
5. printer_find_consumables - 互換性のある消耗品とパーツ番号を見つけます。
6. printer_get_config - 印刷設定ページとWebインターフェイスへのアクセスを取得します。
7. printer_get_stats - データベース情報を取得します。

📦 インストール

前提条件

• Node.js 18以上
• npmまたはyarn

セットアップ

1. このリポジトリをクローンまたはダウンロード して、ローカルマシンに保存します。
2. 依存関係をインストールします：

cd printerMCP
npm install

3. プロジェクトをビルドします：

npm run build

このコマンドにより、以下の処理が行われます：

• TypeScriptをJavaScriptにコンパイルします。
• JSONソースファイルからSQLiteデータベースを構築します。
• サーバーを使用可能な状態に準備します。

💻 使用例

サーバーの実行

Printer MCP Serverは、標準入出力 (stdio) を介して通信します。Claude DesktopのようなMCP互換クライアントとともに使用するように設計されています。

スタンドアロンテスト

npm start

Claude Desktopとの連携

Claude Desktopの設定ファイルに以下の設定を追加します。

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "printer-info": {
      "command": "node",
      "args": [
        "C:/users/brian/printerMCP/dist/index.js"
      ]
    }
  }
}

この設定を追加した後、Claude Desktopを再起動します。

ツールリファレンス

1. printer_search

特定の条件に一致するプリンターを検索します。

パラメーター：

• manufacturer (文字列、オプション): メーカーでフィルタリングします (HP、Canon、Kyoceraなど)。
• formFactor (文字列、オプション): desktop、workgroup、departmental、production。
• type (文字列、オプション): laser、inkjet、led。
• color (ブール値、オプション): カラー印刷機能。
• functions (配列、オプション): 必要な機能 ["print", "copy", "scan", "fax"]。
• minSpeed (数値、オプション): 最低印刷速度 (PPM)。
• maxSpeed (数値、オプション): 最高印刷速度 (PPM)。
• minPrice (数値、オプション): 最低価格 (USD)。
• maxPrice (数値、オプション): 最高価格 (USD)。
• maxDutyMonthly (数値、オプション): 最大月間デューティーサイクル要件。
• keywords (文字列、オプション): 全文検索キーワード。

例：

{
  "manufacturer": "HP",
  "formFactor": "workgroup",
  "color": false,
  "maxPrice": 2000,
  "minSpeed": 40
}

2. printer_get_details

特定のプリンターモデルの完全な情報を取得します。

パラメーター：

• printerId (文字列、必須): プリンターID (例: "hp-m527f", "kyocera-m2640idw")。

戻り値：

• 完全なプリンター仕様
• 販売情報と価格
• ページ単価と消耗品
• セットアップ手順
• トラブルシューティングガイド
• ファームウェア情報
• 保証詳細

3. printer_compare

複数のプリンターモデルを並べて比較します。

パラメーター：

• printerIds (文字列の配列、必須): 比較するプリンターIDの配列。

例：

{
  "printerIds": ["hp-m527f", "kyocera-m2640idw", "epson-et5850"]
}

4. printer_calculate_tco

プリンターの総所有コスト (TCO) を計算します。

パラメーター：

• printerId (文字列、必須): プリンターID。
• monthlyVolume (数値、必須): 予想される月間印刷枚数。
• years (数値、オプション): 年数 (デフォルト: 3)。
• powerCostPerKwh (数値、オプション): 1kWhあたりの電気代 (デフォルト: 0.12)。

戻り値：

• ハードウェアコスト
• 経時的な消耗品コスト
• メンテナンスコスト
• 電力コスト
• 総コストとページ単価

5. printer_find_consumables

プリンターに互換性のあるすべての消耗品を見つけます。

パラメーター：

• printerId (文字列、必須): プリンターID。

戻り値：

• パーツ番号と印刷可能枚数を含むトナー/インクカートリッジ
• ドラムユニット
• メンテナンスキット
• 廃棄容器
• ページ単価情報

6. printer_recommend

要件に基づくインテリジェントなプリンターの推薦を取得します。

パラメーター：

• userCount (数値、必須): ユーザー数。
• monthlyVolume (数値、必須): 予想される月間印刷枚数。
• colorNeeded (ブール値、オプション): カラー印刷の必要性。
• budget (数値、オプション): 予算制約。
• mustHaveFunctions (配列、オプション): 必要な機能。
• environment (文字列、オプション): 使用環境の説明。

戻り値：

• トップ推薦モデル
• 推薦の理由
• 見つかった総一致数

7. printer_get_stats

データベースの統計情報とカバレッジ情報を取得します。

パラメーター：なし

戻り値：

• データベース内のプリンターの総数
• メーカーのリスト
• プリンタータイプ別の内訳
• フォームファクター別の内訳

8. printer_troubleshoot

プリンターの問題に対するトラブルシューティング支援を取得します。

パラメーター：

• printerId (文字列、必須): プリンターID。
• issueType (文字列、必須): error、quality、jam、network。
• errorCode (文字列、オプション): 表示される特定のエラーコード。
• description (文字列、オプション): 問題の説明。

戻り値：

• 関連するトラブルシューティングガイド
• エラーコードの説明と解決策
• 段階的な解決手順
• 修理に必要なパーツ

例：

{
  "printerId": "hp-m527f",
  "issueType": "error",
  "errorCode": "49.XX.XX"
}

9. printer_setup

セットアップとインストール手順を取得します。

パラメーター：

• printerId (文字列、必須): プリンターID。
• setupType (文字列、必須): unboxing、network、driver、all。
• networkType (文字列、オプション): ethernet、wifi、usb (ネットワークセットアップ用)。
• os (文字列、オプション): windows、mac、linux (ドライバーセットアップ用)。

戻り値：

• 段階的なセットアップ手順
• ネットワーク設定ガイド
• ドライバーインストール手順
• 一般的なセットアップ問題と解決策

例：

{
  "printerId": "kyocera-m2640idw",
  "setupType": "network",
  "networkType": "wifi"
}

10. printer_get_config

印刷設定ページの印刷とWebインターフェイスへのアクセスの手順を取得します。

パラメーター：

• printerId (文字列、必須): プリンターID。
• pageType (文字列、オプション): meter、config、network、all (デフォルト: all)。

戻り値：

• メーターページ (印刷枚数) の印刷手順
• 設定ページの印刷
• ネットワーク設定ページ
• Webインターフェイスへのアクセス手順

🔧 技術詳細

データベース構造

このサーバーはハイブリッドアプローチを採用しています：

• ソースデータ：data/printers/ ディレクトリ内の人間が読めるJSONファイル。
• ランタイムデータベース：高速クエリのためにJSONからコンパイルされたSQLiteデータベース。
• 全文検索：キーワードクエリ用の組み込みFTS5検索。

新しいプリンターの追加

1. data/printers/ ディレクトリ内に、src/types.ts のスキーマに従って新しいJSONファイルを作成します。
2. npm run build を実行してデータベースを再構築します。
3. Printer MCP Serverを再起動します。

アーキテクチャ

printerMCP/
├── src/
│   ├── types.ts              # TypeScriptインターフェイスと型
│   ├── build-database.ts      # JSONからSQLiteへのコンパイラ
│   └── index.ts               # MCPサーバーの実装
├── data/
│   └── printers/              # JSONソースファイル
│       ├── hp-laserjet-m527f.json
│       ├── kyocera-ecosys-m2640idw.json
│       └── epson-ecotank-et5850.json
├── dist/                      # コンパイルされたJavaScript (生成される)
├── printers.db                # SQLiteデータベース (生成される)
├── package.json
├── tsconfig.json
└── README.md

データカバレッジ

現在のデータベースには、以下の情報が包括的に含まれています：

• エンタープライズA3/A4複合機
• ワークグループ用レーザーおよびインクジェットデバイス
• SOHO (Small Office/Home Office) プリンター
• 生産用デジタル印刷機

各プリンターエントリには、以下の情報が含まれています：

• 完全な技術仕様
• 価格情報 (定価と実売価格)
• パーツ番号と印刷可能枚数を含む消耗品
• ページ単価計算
• 詳細なセットアップ手順
• 包括的なトラブルシューティングガイド
• ネットワーク設定手順
• メンテナンススケジュール

開発

ビルド

npm run build

ウォッチモード (開発用)

npm run watch

プリンターデータの追加

データベースを拡張するには、以下の構造に従って data/printers/ ディレクトリにJSONファイルを追加します。

{
  "id": "manufacturer-model",
  "manufacturer": "HP",
  "model": "LaserJet Pro MFP M428fdw",
  "series": "LaserJet Pro",
  "formFactor": "workgroup",
  "type": "laser",
  "color": false,
  "functions": ["print", "copy", "scan", "fax"],
  "specifications": { ... },
  "sales": { ... },
  "costs": { ... },
  "setup": { ... },
  "troubleshooting": { ... }
}

完全なスキーマ定義については、src/types.ts を参照してください。

📚 ドキュメント

利用シーン

販売チーム向け

• 顧客の要件に合致するプリンターを迅速に見つける
• 競合モデルを並べて比較する
• 顧客にTCOを計算して提示する
• 正確な消耗品コストとパーツ番号を提供する
• 使用パターンに基づく推薦を生成する

サービスチーム向け

• 迅速なエラーコードの検索と解決
• 段階的なトラブルシューティングガイド
• ネットワークセットアップと設定支援
• 消耗品の識別と注文
• メンテナンススケジュールと手順

IT部門向け

• フリート展開用のプリンターを評価する
• 予算編成のためのTCO分析
• 調達用の技術仕様
• セットアップと設定ドキュメント
• トラブルシューティングの知識ベース

📄 ライセンス

このプロジェクトはMITライセンスのもとで公開されています。

コントリビューション

追加のプリンターデータを提供するには、以下の手順に従ってください：

1. src/types.ts のJSONスキーマに従います。
2. 包括的なトラブルシューティングとセットアップ情報を追加します。
3. 正確なパーツ番号と仕様を含めます。
4. データベースを再構築してデータをテストします。

サポート

問題や質問がある場合は、以下の方法で対応してください：

• プリンターデータ内のトラブルシューティングガイドを確認します。
• 上記のツールリファレンスを確認します。
• npm run build を実行してデータベースが正常に構築されたことを確認します。

バージョン履歴

1.0.0 (2025-01-13)

• 初期リリース
• 販売チームとサービスチーム向けの10のインテリジェントツール
• 9つの主要メーカーのサポート
• 包括的なプリンターデータベース
• 全文検索機能
• TCO計算エンジン
• トラブルシューティングの知識ベース