시작하기

MCP

Claude 같은 MCP 클라이언트에서 도구 33종을 그대로 사용합니다.

설정

클라이언트 설정에 서버를 등록하세요. 도구 목록은 서버가 /api/v1/tools 에서 읽어 오므로, 여기에 도구 이름을 적을 필요가 없습니다.

PAH_TOOLS_APIstring기본값 https://tools.pah.kr

도구 서버 주소입니다.

PAH_TOOLS_OUTstring기본값 ~/Downloads

결과를 저장할 기본 폴더입니다.

파일을 주고받는 방식

파일은 base64 가 아니라 내 컴퓨터의 경로로 주고받습니다. 대화창에 파일 내용이 흐르지 않고, 결과도 지정한 폴더에 바로 저장됩니다.

filesstring[]필수

처리할 파일의 로컬 절대 경로입니다.

textstring

글자를 받는 도구에서만 사용합니다.

outputDirstring

결과를 저장할 폴더입니다. 지정하지 않으면 PAH_TOOLS_OUT 을 씁니다.

도구 이름

REST 의 도구 id 에서 하이픈이 밑줄로 바뀝니다. pdf-merge → pdf_merge, image-id-photo → image_id_photo.

서버가 준비되지 않은 도구(ready: false)는 목록에 올리지 않습니다. 쓸 수 없는 도구를 클라이언트가 고르는 일을 막기 위해서입니다.

설정

{
  "mcpServers": {
    "pah-tools": {
      "command": "node",
      "args": ["/path/to/pah-tools/mcp/server.mjs"],
      "env": {
        "PAH_TOOLS_API": "https://utils.pah.kr",
        "PAH_TOOLS_OUT": "/Users/me/Downloads"
      }
    }
  }
}

도구 호출

{
  "name": "pdf_merge",
  "arguments": {
    "files": [
      "/Users/me/Documents/a.pdf",
      "/Users/me/Documents/b.pdf"
    ],
    "outputDir": "/Users/me/Downloads"
  }
}

결과

5쪽
저장: /Users/me/Downloads/merged.pdf