Zhimu Cloud Printing MCP

webprinter_mcp는 클라우드 인쇄를 위한 MCP 서버입니다.
사용 중인 MCP 클라이언트가 stdio 유형의 MCP를 지원한다면, 이를 통해 파일 업로드, 프린터 조회, 인쇄 작업 제출 및 직접 인쇄를 수행할 수 있습니다.

주요 기능

이 도구는 "인쇄 작업을 대신 처리해 주는 도구"로 이해하시면 됩니다.

예를 들어, 이 MCP가 연결된 AI에게 다음과 같이 요청할 수 있습니다:

• "지금 사용 가능한 프린터가 있는지 확인해 줘"

• "이 파일을 업로드해서 인쇄 준비를 해 줘"

• "이 파일을 인쇄 대기열에 추가해 줘"

• "사무실에 있는 그 프린터로 바로 인쇄해 줘"

• "방금 그 작업을 양면 인쇄로 바꿔 줘"

사용 전 준비 사항

먼저 Zhimu Cloud Printing 서버를 설치하고 프린터 공유를 완료해야 합니다. Zhimu Cloud Printing에서 설치 패키지를 다운로드하세요:

• https://any.webprinter.cn

그런 다음, 클라우드 인쇄 액세스 토큰(token)을 받아야 합니다.

토큰 획득 주소:

• [https://any.webprinter.cn/get-ai-server-token](https://any.webprinter.cn/get-ai-server-token)

토큰을 받은 후 환경 변수를 설정하세요:

• WEBPRINTER_ACCESS_TOKEN: 필수 입력

설치

pip으로 설치

pip install webprinter_mcp

또는 소스 코드에서 설치

pip install .

실행 방법

로컬에서 정상적으로 실행되는지 확인하려면 다음을 실행하세요:

webprinter_mcp

또는:

python -m webprinter_mcp

주의: 이 명령어를 실행한 후에는 일반적으로 별도의 프롬프트 메시지가 출력되지 않습니다.
MCP 클라이언트의 연결을 기다리는 상태가 되며, 이는 정상입니다.

MCP 클라이언트 설정 방법

현재 이 프로젝트는 stdio 방식으로 연결하는 것이 가장 적합합니다.

로컬 Python 방식

로컬 환경에 패키지가 설치되어 있다면 다음과 같이 설정하는 것을 권장합니다:

{
  "type": "stdio",
  "config": {
    "mcpServers": {
      "webprinter": {
        "type": "stdio",
        "command": "webprinter_mcp",
        "args": [],
        "env": {
          "WEBPRINTER_ACCESS_TOKEN": "your-access-token"
        }
      }
    }
  }
}

npx 방식

클라이언트가 npx 스타일을 지원한다면 다음과 같이 설정할 수 있습니다:

{
  "type": "stdio",
  "config": {
    "mcpServers": {
      "webprinter": {
        "type": "npx",
        "command": "npx",
        "args": ["-y", "webprinter_mcp"],
        "env": {
          "WEBPRINTER_ACCESS_TOKEN": "your-access-token"
        }
      }
    }
  }
}

주의: npx webprinter_mcp를 사용하는 경우에도 로컬에 Python 실행 환경이 필요합니다.

초기 연결 시 권장 테스트 방법

처음 사용할 때는 다음 순서대로 진행하는 것을 권장합니다:

1. 현재 계정이 클라우드 인쇄 조건을 갖췄는지 확인

다음과 같이 요청해 보세요:

• "현재 환경에서 클라우드 인쇄를 정상적으로 사용할 수 있는지 확인해 줘"

결과에 클라이언트나 장치가 준비되지 않았다고 나오면, WebPrinter 측의 설치 및 공유 설정을 먼저 완료하세요.

2. 현재 사용 가능한 프린터 목록 확인

다음과 같이 요청해 보세요:

• "지금 사용할 수 있는 프린터가 무엇인지 알려 줘"

이 단계에서 일반적으로 다음 정보를 얻을 수 있습니다:

• 프린터 이름

• 프린터 별칭

• 온라인 상태

• 제어 단말 번호

3. 로컬 파일이 있는 경우 업로드

다음과 같이 요청할 수 있습니다:

• "내 로컬에 있는 이 PDF를 업로드해서 인쇄 가능한 주소를 줘"

로컬 디버깅 시 일반적인 매개변수는 다음과 같습니다:

{
  "file_path": "C:\\\\docs\\\\report.pdf"
}

4. '로밍 인쇄' 또는 '직접 인쇄' 결정

인쇄 대기열에 먼저 넣고 싶다면 다음과 같이 요청하세요:

• "이 파일을 로밍 인쇄로 제출해 줘" 또는

• "이 파일을 인쇄 대기열에 추가해 줘"

특정 프린터로 즉시 인쇄하려면 다음과 같이 요청하세요:

• "이 파일을 사무실에 있는 HP 프린터로 바로 인쇄해 줘"

자연어 사용 예시

다음과 같은 표현들이 이 MCP를 활용하기에 적합합니다:

• "현재 클라우드 인쇄 환경이 사용 가능한지 확인해 줘"

• "사용 가능한 프린터 목록을 보여 줘"

• "내 바탕화면에 있는 PDF를 업로드해 줘"

• "이 웹 페이지를 인쇄 대기열에 추가해 줘"

• "안내 데스크에 있는 프린터로 바로 인쇄해 줘"

• "방금 그 작업을 양면 인쇄로 변경해 줘"

자주 묻는 질문

webprinter_mcp 실행 후 반응이 없어요

정상입니다.
실행 후 MCP 클라이언트가 stdio를 통해 연결되기를 기다리는 상태이므로, 일반적인 명령줄 도구처럼 즉시 많은 정보를 출력하지 않습니다.

실행 시 토큰 관련 오류가 발생하면 어떻게 하나요?

먼저 여기서 토큰을 받으세요:

• [https://get-ai-token.webprinter.cn](https://any.webprinter.cn/get-ai-server-token)

그런 다음 다음 환경 변수가 설정되었는지 확인하세요:

• WEBPRINTER_ACCESS_TOKEN

명령어를 설치했는데 webprinter_mcp를 찾을 수 없어요

보통 Python의 Scripts 디렉토리가 PATH에 추가되지 않았기 때문입니다.
이 경우 다음과 같이 직접 실행할 수 있습니다:

python -m webprinter_mcp

작업 설정 도구

이미 생성된 로밍 인쇄 작업에 대해 다음 설정을 수정할 수 있습니다:

• update_printer_side(task_id, side)

• update_printer_color(task_id, color)

• update_printer_copies(task_id, copies)

• update_printer_paper(task_id, paper)

매개변수 설명

• task_id

  • 로밍 인쇄 작업 ID

• side

  • 선택 값: ONESIDE, DUPLEX, TUMBLE

  • 각각 단면, 양면 긴 가장자리 넘김, 양면 짧은 가장자리 넘김을 의미

• color

  • 선택 값: COLOR, MONOCHROME

  • 각각 컬러, 흑백을 의미

• copies

  • 정수

  • 1 이상이어야 함

• paper

  • 용지 유형 이름(예: A3, A4, A5, LETTER)을 직접 전달 가능

  • 사용자 정의 객체 전달 가능: {"width": 210, "height": 297}

  • 가로/세로 단위는 밀리미터(mm)

사용 예시

MCP 클라이언트에서 자연어로 호출할 경우:

• "작업 123을 양면 인쇄로 바꿔 줘"

• "작업 123을 흑백 인쇄로 바꿔 줘"

• "작업 123을 3부 인쇄로 바꿔 줘"

• "작업 123을 A4 용지로 바꿔 줘"

• "작업 123을 가로 210, 세로 297 용지로 바꿔 줘"

로컬 CLI에서 디버깅할 경우:

python scripts/mcp_client.py update-printer-side --task-id 123 --side DUPLEX
python scripts/mcp_client.py update-printer-color --task-id 123 --color MONOCHROME
python scripts/mcp_client.py update-printer-copies --task-id 123 --copies 3
python scripts/mcp_client.py update-printer-paper --task-id 123 --paper A4
python scripts/mcp_client.py update-printer-paper --task-id 123 --width 210 --height 297