打印机MCP服务器
一个全面的模型上下文协议（MCP）服务器，为销售和服务团队提供企业打印机信息。访问主要企业打印机品牌的详细规格、定价、故障排除和设置信息。
特性
支持的制造商
- 惠普 （惠普）
- 佳能
- 京瓷
- 柯尼卡美能达
- 夏普
- 利盟
- 理光
- 兄弟
- 爱普生
10智能工具
该服务器为销售和服务团队提供了专门的工具：
销售团队工具
- 打印机搜索 -按规格、预算、功能或关键字查找打印机
- 打印机_获取_详细信息 -获取完整的型号信息，包括规格、定价和功能
- 打印机_比较 -多个模型的并排比较
- 打印机_计算器_tco -随时间变化的总拥有成本分析
- 打印机_查找_耗材 -带有零件号和成本的兼容碳粉/耗材
- 打印机_推荐 -基于业务需求的人工智能推荐
- printer_get_stats -数据库覆盖率和统计数据
服务团队工具
- 打印机搜索 -按规格查找打印机
- 打印机_获取_详细信息 -完整的型号和技术信息
- 打印机_故障排除 -错误代码处理和问题解决
- 打印机设置 -按型号和制造商列出的设置说明
- 打印机_查找_耗材 -兼容的供应品和零件号
- printer_get_config -打印配置页面和web界面访问
- printer_get_stats -数据库信息
安装
先决条件
- Node.js 18或更高版本
- npm或纱线
设置
- 克隆或下载 将此存储库连接到本地计算机
- 安装依赖项：
cd printerMCP
npm install- 构建项目：
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（字符串，可选）：激光、喷墨、ledcolor（布尔值，可选）：彩色打印功能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（字符串，必填）：打印机IDmonthlyVolume（数量，必填）：预计每月页数years（数字，可选）：年数（默认值：3）powerCostPerKwh（数字，可选）：每千瓦时的电费（默认值：0.12）
退货：
- 硬件成本
- 消耗品成本随时间变化
- 维护费用
- 电力成本
- 总成本和每页成本
5.打印机_查找_耗材
查找打印机的所有兼容耗材。
参数：
printerId（字符串，必填）：打印机ID
退货：
- 带有零件号和产量的碳粉/墨盒
- 滚筒装置
- 维护工具包
- 废物容器
- 每页成本信息
6.打印机_推荐
根据需求获取智能打印机建议。
参数：
userCount（number，必填）：用户数量monthlyVolume（数字，必填）：预计每月页数colorNeeded（布尔值，可选）：需要彩色打印budget（数字，可选）：预算限制mustHaveFunctions（数组，可选）：必需函数environment（字符串，可选）：使用环境描述
退货：
- 顶级推荐型号
- 建议的推理
- 找到的匹配项总数
7.打印机_获取_启动
获取数据库统计信息和覆盖率信息。
参数： 无
退货：
- 数据库中的打印机总数
- 制造商列表
- 按打印机类型细分
- 按外形尺寸细分
8.打印机_故障排除
获取打印机问题的故障排除帮助。
参数：
printerId（字符串，必填）：打印机IDissueType（字符串，必填）：错误、质量、堵塞、网络errorCode（字符串，可选）：显示特定错误代码description（字符串，可选）：问题描述
退货：
- 相关故障排除指南
- 错误代码解释和解决方案
- 逐步解决程序
- 维修所需零件
例子：
{
"printerId": "hp-m527f",
"issueType": "error",
"errorCode": "49.XX.XX"
}9.打印机设置
获取设置和安装说明。
参数：
printerId（字符串，必填）：打印机IDsetupType（string，必填）：拆箱、网络、驱动程序、全部networkType（字符串，可选）：以太网、wifi、usb（用于网络设置）os（字符串，可选）：windows、mac、linux（用于驱动程序设置）
退货：
- 分步设置说明
- 网络配置指南
- 驱动器安装程序
- 常见的设置问题和解决方案
例子：
{
"printerId": "kyocera-m2640idw",
"setupType": "network",
"networkType": "wifi"
}10.printer_get_config
获取打印配置页面和访问web界面的说明。
参数：
printerId（字符串，必填）：打印机IDpageType（字符串，可选）：仪表、配置、网络、全部（默认：全部）
退货：
- 打印仪表页（页数）的说明
- 配置页面打印
- 网络配置页面
- Web界面访问说明
数据库结构
服务器使用混合方法：
- 源数据：人类可读的JSON文件
data/printers/ - 运行时数据库：从JSON编译的SQLite数据库，用于快速查询
- 全文检索：内置FTS5搜索关键字查询
添加新打印机
- 在中创建一个新的JSON文件
data/printers/遵循中的架构src/types.ts - 跑
npm run build重建数据库 - 重新启动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分析
- 采购技术规范
- 设置和配置文档
- 故障排除知识库
许可证
麻省理工学院
贡献
要提供其他打印机数据，请执行以下操作：
- 遵循JSON模式
src/types.ts - 添加全面的故障排除和设置信息
- 包括准确的零件号和规格
- 通过重建数据库来测试数据
支持
对于问题或疑问：
- 查看打印机数据中的故障排除指南
- 查看上面的工具参考
- 验证数据库是否已成功构建
npm run build
版本历史记录
1.0.0 (2025-01-13)
- 初始版本
- 10种智能销售和服务工具
- 支持9家主要制造商
- 全面的打印机数据库
- 全文搜索功能
- TCO计算引擎
- 故障排除知识库