Pc Hardware MCP

🚀 打印機MCP服務器

這是一個全面的模型上下文協議（MCP）服務器，專為銷售和服務團隊提供企業打印機信息。通過該服務器，可獲取主要企業打印機品牌的詳細規格、價格、故障排除和設置信息。

🚀 快速開始

本MCP服務器通過標準輸入輸出進行通信，設計用於與MCP兼容的客戶端（如Claude Desktop）配合使用。

獨立測試

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。

✨ 主要特性

支持的製造商

• 惠普（Hewlett - Packard）
• 佳能
• 京瓷
• 柯尼卡美能達
• 夏普
• 利盟
• 理光
• 兄弟
• 愛普生

10個智能工具

本服務器為銷售和服務團隊提供了專業工具：

銷售團隊工具

1. printer_search：通過規格、預算、功能或關鍵字查找打印機。
2. printer_get_details：獲取包括規格、價格和功能在內的完整型號信息。
3. printer_compare：對多個型號進行並排比較。
4. printer_calculate_tco：分析打印機隨時間的總體擁有成本。
5. printer_find_consumables：查找兼容的碳粉/耗材，包括零件編號和成本。
6. printer_recommend：基於業務需求提供人工智能推薦。
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數據庫。
• 準備好服務器以供使用。

💻 使用示例

基礎用法

# 獨立測試啟動服務器
npm start

高級用法

# 在Claude Desktop配置文件中添加服務器配置
{
  "mcpServers": {
    "printer-info": {
      "command": "node",
      "args": [
        "C:/users/brian/printerMCP/dist/index.js"
      ]
    }
  }
}

📚 詳細文檔

工具參考

1. printer_search

根據特定條件搜索打印機。

參數：

• manufacturer（字符串，可選）：按製造商過濾（如惠普、佳能、京瓷等）。
• formFactor（字符串，可選）：臺式、工作組、部門級、生產型。
• type（字符串，可選）：激光、噴墨、LED。
• color（布爾值，可選）：是否具備彩色打印功能。
• functions（數組，可選）：所需功能（如["打印", "複印", "掃描", "傳真"]）。
• minSpeed（數字，可選）：最小打印速度（每分鐘頁數）。
• maxSpeed（數字，可選）：最大打印速度（每分鐘頁數）。
• minPrice（數字，可選）：最低價格（美元）。
• maxPrice（數字，可選）：最高價格（美元）。
• maxDutyMonthly（數字，可選）：每月最大工作負荷要求。
• keywords（字符串，可選）：全文搜索關鍵字。

示例：

{
  "manufacturer": "惠普",
  "formFactor": "工作組",
  "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

計算打印機的總體擁有成本。

參數：

• printerId（字符串，必需）：打印機ID。
• monthlyVolume（數字，必需）：預計每月打印頁數。
• years（數字，可選）：使用年限（默認值：3年）。
• powerCostPerKwh（數字，可選）：每千瓦時電費（默認值：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（字符串，必需）：錯誤、質量、卡紙、網絡問題。
• errorCode（字符串，可選）：顯示的特定錯誤代碼。
• description（字符串，可選）：問題描述。

返回值：

• 相關的故障排除指南。
• 錯誤代碼解釋和解決方案。
• 逐步解決程序。
• 維修所需的零件。

示例：

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

9. printer_setup

獲取設置和安裝說明。

參數：

• printerId（字符串，必需）：打印機ID。
• setupType（字符串，必需）：拆箱、網絡、驅動程序、全部。
• networkType（字符串，可選）：以太網、Wi - Fi、USB（用於網絡設置）。
• os（字符串，可選）：Windows、Mac、Linux（用於驅動程序設置）。

返回值：

• 逐步設置說明。
• 網絡配置指南。
• 驅動程序安裝程序。
• 常見設置問題和解決方案。

示例：

{
  "printerId": "kyocera - m2640idw",
  "setupType": "網絡",
  "networkType": "Wi - Fi"
}

10. printer_get_config

獲取打印配置頁面和訪問Web界面的說明。

參數：

• printerId（字符串，必需）：打印機ID。
• pageType（字符串，可選）：計量、配置、網絡、全部（默認值：全部）。

返回值：

• 打印計量頁面（頁面計數）的說明。
• 配置頁面打印。
• 網絡配置頁面。
• Web界面訪問說明。

數據庫結構

服務器採用混合方法：

• 源數據：data/printers/ 中的人類可讀JSON文件。
• 運行時數據庫：從JSON編譯的SQLite數據庫，用於快速查詢。
• 全文搜索：內置FTS5搜索，用於關鍵字查詢。

添加新打印機

1. 在 data/printers/ 中創建一個新的JSON文件，遵循 src/types.ts 中的架構。
2. 運行 npm run build 重新構建數據庫。
3. 重啟MCP服務器。

架構

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）打印機。
• 生產型數字印刷機。

每個打印機條目包括：

• 完整的技術規格。
• 定價信息（建議零售價和市場價格）。
• 帶有零件編號和打印量的耗材。
• 每頁成本計算。
• 詳細的設置說明。
• 全面的故障排除指南。
• 網絡配置程序。
• 維護計劃。

開發

構建

npm run build

開發模式（監聽文件變化）

npm run watch

添加更多打印機

要擴展數據庫，請在 data/printers/ 中添加遵循以下結構的JSON文件：

{
  "id": "manufacturer - model",
  "manufacturer": "惠普",
  "model": "LaserJet Pro MFP M428fdw",
  "series": "LaserJet Pro",
  "formFactor": "工作組",
  "type": "激光",
  "color": false,
  "functions": ["打印", "複印", "掃描", "傳真"],
  "specifications": { ... },
  "sales": { ... },
  "costs": { ... },
  "setup": { ... },
  "troubleshooting": { ... }
}

完整的架構定義請參考 src/types.ts。

使用場景

銷售團隊

• 快速找到符合客戶要求的打印機。
• 並排比較競爭型號。
• 計算並向客戶展示總體擁有成本。
• 提供準確的耗材成本和零件編號。
• 根據使用模式生成推薦。

服務團隊

• 快速查找錯誤代碼並解決問題。
• 遵循逐步故障排除指南。
• 獲得網絡設置和配置幫助。
• 識別和訂購耗材。
• 遵循維護計劃和程序。

IT部門

• 評估打印機以進行批量部署。
• 進行總體擁有成本分析以進行預算規劃。
• 獲取採購所需的技術規格。
• 獲取設置和配置文檔。
• 利用故障排除知識庫。

🔧 技術細節

服務器使用Node.js和SQLite構建，通過標準輸入輸出與MCP兼容的客戶端進行通信。它將JSON源文件編譯為SQLite數據庫，以實現快速查詢，並利用內置的FTS5進行全文搜索。

📄 許可證

本項目採用MIT許可證。

貢獻說明

若要貢獻額外的打印機數據，請遵循以下步驟：

1. 遵循 src/types.ts 中的JSON架構。
2. 添加全面的故障排除和設置信息。
3. 包含準確的零件編號和規格。
4. 通過重新構建數據庫來測試數據。

支持說明

若遇到問題或有疑問，請按以下步驟操作：

• 查看打印機數據中的故障排除指南。
• 參考上述工具參考文檔。
• 使用 npm run build 驗證數據庫是否成功構建。

版本歷史

1.0.0（2025 - 01 - 13）

• 初始版本發佈。
• 為銷售和服務團隊提供10個智能工具。
• 支持9個主要製造商。
• 提供全面的打印機數據庫。
• 具備全文搜索功能。
• 包含總體擁有成本計算引擎。
• 提供故障排除知識庫。