Printer-AI

Printer AI MCP is a Python-based MCP server that provides printer management, status queries, and file printing capabilities across Windows, macOS, and Linux. It exposes tools to list available printers, query printer status, retrieve printer attributes (macOS/Linux), and print files with configurable options. The server is designed to integrate with the MCP protocol, enabling AI assistant interactions for managing print jobs and querying printer information. To interact with the server, start it locally and use the included functions (get_printer_list, printer_status, printer_attrs, and print_file) via your MCP-enabled client or automation scripts. The API responses follow a consistent structure with code, message, and data payloads for easy parsing by automation tools and assistants.

Prerequisites:

• Python 3.10 or newer
• Operating system with printer support (Windows, macOS with CUPS, or Linux with CUPS)

Installation steps:

1. Clone the repository: git clone https://github.com/NullYing/printer-ai-mcp.git cd printer-ai-mcp

2. (Optional but recommended) Create and activate a virtual environment:

   • Python venv on Windows: python -m venv venv venv\Scripts\activate
   • Python venv on macOS/Linux: python3 -m venv venv source venv/bin/activate

3. Install dependencies (via Poetry or pip if a requirements file is provided):

   • If a pyproject.toml is present and you use Poetry: poetry install
   • If using pip with a requirements file (if available): pip install -r requirements.txt

4. Start the MCP server: python main.py

5. Verify the server is running by accessing the default MCP endpoint (as defined by the project). For example, connect through your MCP client using the server name printerAIMcp and the command configuration described in mcp_config.

Notes and tips:

• The server provides printer management, status queries, and file printing. Ensure your system has printers configured and accessible (CUPS on macOS/Linux).
• If you run into permissions issues printing from some applications, ensure the user running the MCP server has appropriate access to system printers.
• The MCP configuration uses a single server named printerAIMcp; adjust as needed for multi-instance deployments.
• Logs and error messages are typically printed to stdout/stderr; check console output for troubleshooting.
• The API responses use a standard format: { "code": 200, "msg": "success", "data": { ... } }.