Printer MCP Server

打印机MCP服务器

一个全面的模型上下文协议（MCP）服务器，为销售和服务团队提供企业打印机信息。访问主要企业打印机品牌的详细规格、定价、故障排除和设置信息。

特性

支持的制造商

• 惠普 （惠普）
• 佳能
• 京瓷
• 柯尼卡美能达
• 夏普
• 利盟
• 理光
• 兄弟
• 爱普生

10智能工具

该服务器为销售和服务团队提供了专门的工具：

销售团队工具

1. 打印机搜索 -按规格、预算、功能或关键字查找打印机
2. 打印机_获取_详细信息 -获取完整的型号信息，包括规格、定价和功能
3. 打印机_比较 -多个模型的并排比较
4. 打印机_计算器_tco -随时间变化的总拥有成本分析
5. 打印机_查找_耗材 -带有零件号和成本的兼容碳粉/耗材
6. 打印机_推荐 -基于业务需求的人工智能推荐
7. printer_get_stats -数据库覆盖率和统计数据

服务团队工具

1. 打印机搜索 -按规格查找打印机
2. 打印机_获取_详细信息 -完整的型号和技术信息
3. 打印机_故障排除 -错误代码处理和问题解决
4. 打印机设置 -按型号和制造商列出的设置说明
5. 打印机_查找_耗材 -兼容的供应品和零件号
6. printer_get_config -打印配置页面和web界面访问
7. printer_get_stats -数据库信息

安装

先决条件

• Node.js 18或更高版本
• npm或纱线

设置

1. 克隆或下载 将此存储库连接到本地计算机

1. 安装依赖项：

cd printerMCP
npm install

1. 构建项目：

npm run build

此命令将：

• 将TypeScript编译为JavaScript
• 从JSON源文件构建SQLite数据库
• 准备服务器以供使用

用法

运行服务器

MCP服务器通过stdio进行通信。它被设计为与MCP兼容的客户端（如Claude Desktop）一起使用。

独立测试

npm start

使用克劳德桌面

将此配置添加到您的Claude Desktop配置文件中：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

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

添加此配置后重新启动Claude Desktop。

工具参考

1.打印机_搜索

搜索符合特定条件的打印机。

参数：

• manufacturer （字符串，可选）：按制造商（惠普、佳能、京瓷等）筛选
• formFactor （字符串，可选）：桌面、工作组、部门、生产
• type （字符串，可选）：激光、喷墨、led
• color （布尔值，可选）：彩色打印功能
• functions （数组，可选）：必需功能\[“打印”、“复印”、“扫描”、“传真”\]
• minSpeed （数字，可选）：最小打印速度（PPM）
• maxSpeed （数字，可选）：最大打印速度（PPM）
• minPrice （数字，可选）：最低价格（美元）
• maxPrice （数字，可选）：最高价格（美元）
• maxDutyMonthly （数量，可选）：每月最大工作周期要求
• keywords （字符串，可选）：全文搜索关键字

例子：

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

2.打印机_获取_详细信息

获取特定打印机型号的完整信息。

参数：

• printerId （字符串，必填）：打印机ID（例如，“hp-m527f”、“kyocera-m2640idw”）

退货：

• 完整的打印机规格
• 销售信息和定价
• 每页成本和耗材
• 安装说明
• 故障排除指南
• 固件信息
• 保修详情

3.打印机_比较

并排比较多个打印机型号。

参数：

• printerIds （字符串数组，必填）：要比较的打印机ID数组

例子：

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

4.打印机_计算器_tco

计算打印机的总拥有成本。

参数：

• printerId （字符串，必填）：打印机ID
• monthlyVolume （数量，必填）：预计每月页数
• years （数字，可选）：年数（默认值：3）
• powerCostPerKwh （数字，可选）：每千瓦时的电费（默认值：0.12）

退货：

• 硬件成本
• 消耗品成本随时间变化
• 维护费用
• 电力成本
• 总成本和每页成本

5.打印机_查找_耗材

查找打印机的所有兼容耗材。

参数：

• printerId （字符串，必填）：打印机ID

退货：

• 带有零件号和产量的碳粉/墨盒
• 滚筒装置
• 维护工具包
• 废物容器
• 每页成本信息

6.打印机_推荐

根据需求获取智能打印机建议。

参数：

• userCount （number，必填）：用户数量
• monthlyVolume （数字，必填）：预计每月页数
• colorNeeded （布尔值，可选）：需要彩色打印
• budget （数字，可选）：预算限制
• mustHaveFunctions （数组，可选）：必需函数
• environment （字符串，可选）：使用环境描述

退货：

• 顶级推荐型号
• 建议的推理
• 找到的匹配项总数

7.打印机_获取_启动

获取数据库统计信息和覆盖率信息。

参数： 无

退货：

• 数据库中的打印机总数
• 制造商列表
• 按打印机类型细分
• 按外形尺寸细分

8.打印机_故障排除

获取打印机问题的故障排除帮助。

参数：

• printerId （字符串，必填）：打印机ID
• issueType （字符串，必填）：错误、质量、堵塞、网络
• errorCode （字符串，可选）：显示特定错误代码
• description （字符串，可选）：问题描述

退货：

• 相关故障排除指南
• 错误代码解释和解决方案
• 逐步解决程序
• 维修所需零件

例子：

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

9.打印机设置

获取设置和安装说明。

参数：

• printerId （字符串，必填）：打印机ID
• setupType （string，必填）：拆箱、网络、驱动程序、全部
• networkType （字符串，可选）：以太网、wifi、usb（用于网络设置）
• os （字符串，可选）：windows、mac、linux（用于驱动程序设置）

退货：

• 分步设置说明
• 网络配置指南
• 驱动器安装程序
• 常见的设置问题和解决方案

例子：

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

10.printer_get_config

获取打印配置页面和访问web界面的说明。

参数：

• printerId （字符串，必填）：打印机ID
• pageType （字符串，可选）：仪表、配置、网络、全部（默认：全部）

退货：

• 打印仪表页（页数）的说明
• 配置页面打印
• 网络配置页面
• Web界面访问说明

数据库结构

服务器使用混合方法：

• 源数据：人类可读的JSON文件 data/printers/
• 运行时数据库：从JSON编译的SQLite数据库，用于快速查询
• 全文检索：内置FTS5搜索关键字查询

添加新打印机

1. 在中创建一个新的JSON文件 data/printers/ 遵循中的架构 src/types.ts
2. 跑 npm run build 重建数据库
3. 重新启动MCP服务器

建筑

printerMCP/
├── src/
│   ├── types.ts              # TypeScript interfaces and types
│   ├── build-database.ts      # JSON to SQLite compiler
│   └── index.ts               # MCP server implementation
├── data/
│   └── printers/              # JSON source files
│       ├── hp-laserjet-m527f.json
│       ├── kyocera-ecosys-m2640idw.json
│       └── epson-ecotank-et5850.json
├── dist/                      # Compiled JavaScript (generated)
├── printers.db                # SQLite database (generated)
├── package.json
├── tsconfig.json
└── README.md

数据覆盖

当前数据库包括以下方面的综合信息：

• 企业A3/A4多功能一体机
• 工作组激光和喷墨设备
• SOHO（小型办公室/家庭办公室）打印机
• 生产数字印刷机

每个打印机条目包括：

• 完整的技术规格
• 定价信息（MSRP和街道价格）
• 带有零件号和产量的耗材
• 每页成本计算
• 详细的设置说明
• 全面的故障排除指南
• 网络配置程序
• 维护计划

发展

构建

npm run build

观看模式（用于开发）

npm run watch

添加更多打印机

要扩展数据库，请将JSON文件添加到 data/printers/ 遵循此结构：

{
  "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分析
• 采购技术规范
• 设置和配置文档
• 故障排除知识库

许可证

麻省理工学院

贡献

要提供其他打印机数据，请执行以下操作：

1. 遵循JSON模式 src/types.ts
2. 添加全面的故障排除和设置信息
3. 包括准确的零件号和规格
4. 通过重建数据库来测试数据

支持

对于问题或疑问：

• 查看打印机数据中的故障排除指南
• 查看上面的工具参考
• 验证数据库是否已成功构建 npm run build

版本历史记录

1.0.0 (2025-01-13)

• 初始版本
• 10种智能销售和服务工具
• 支持9家主要制造商
• 全面的打印机数据库
• 全文搜索功能
• TCO计算引擎
• 故障排除知识库