@gasio/mcp-server

100% 로컬 오프라인 AI 미디어 처리 MCP 서버

Gasio Tools 생태계의 14종 이미지/미디어 처리 기능을 Claude Desktop 등 MCP 지원 AI 에이전트에서 100% 로컬 오프라인으로 사용할 수 있는 Model Context Protocol 서버입니다.

파일이 외부 서버에 절대 업로드되지 않습니다. 모든 연산은 사용자의 컴퓨터 내부에서만 처리됩니다.

🛠️ 제공 도구 (14종)

🎨 이미지 AI 처리 (Season 2)

🎬 미디어 변환 & 편집 (Season 1)

📦 설치 및 셋업

1단계: 글로벌 설치

npm install -g @gasio/mcp-server

또는 npx로 바로 실행:

npx @gasio/mcp-server

2단계: AI 모델 자동 다운로드 (최초 1회)

OCR, 배경 제거, 화질 개선 도구는 AI 모델 파일이 필요합니다.

npx gasio-mcp-setup

이 명령은 다음 리소스를 ~/.gasio/ 디렉토리에 자동으로 다운로드합니다: - ~/.gasio/tesseract/eng.traineddata — Tesseract 영어 모델 - ~/.gasio/tesseract/kor.traineddata — Tesseract 한국어 모델 - ~/.gasio/models/realesrgan-x4.onnx — RealESRGAN 업스케일 모델 (~67MB) - ~/.gasio/models/super-resolution.onnx — Super Resolution 모델

⚙️ Claude Desktop 연동 설정

claude_desktop_config.json 파일에 다음을 추가하세요:

macOS 경로: ~/Library/Application Support/Claude/claude_desktop_config.json Windows 경로: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "gasio": {
      "command": "npx",
      "args": ["-y", "@gasio/mcp-server"]
    }
  }
}

글로벌 설치 후 직접 node 실행을 원하는 경우:

{
  "mcpServers": {
    "gasio": {
      "command": "node",
      "args": ["/절대경로/node_modules/@gasio/mcp-server/dist/src/index.js"]
    }
  }
}

📋 도구별 사용 예시

배경 제거

이미지 /Users/me/photo.jpg 에서 배경을 제거해서 /Users/me/output/photo-bg-removed.png 로 저장해줘

→ Claude가 gasio_remove_background 도구를 자동 호출

OCR 텍스트 추출

/Users/me/screenshot.png 이미지에서 한국어 텍스트를 추출해줘

→ Claude가 gasio_image_to_text_ocr 도구를 lang: "kor" 옵션으로 호출

QR 코드 생성

https://tools.gasio.com URL로 QR 코드를 만들어서 /Users/me/qr.png 에 저장해줘

→ Claude가 gasio_qrcode_generator 도구를 자동 호출

파비콘 세트 생성

/Users/me/logo.png 로 파비콘 세트를 /Users/me/favicon-output/ 에 만들어줘

→ Claude가 gasio_favicon_generator 도구로 favicon.ico, apple-touch-icon.png, site.webmanifest 등을 일괄 생성

🔧 도구별 상세 파라미터

<details> <summary><b>gasio_remove_background</b> - 배경 제거</summary>

</details>

<details> <summary><b>gasio_object_eraser</b> - 개체 지우기</summary>

</details>

<details> <summary><b>gasio_image_upscaler</b> - 화질 개선</summary>

ONNX 모델이 없거나 로드 실패 시 Jimp BICUBIC 보간으로 자동 Fallback합니다.

</details>

<details> <summary><b>gasio_image_resizer</b> - 이미지 리사이즈</summary>

</details>

<details> <summary><b>gasio_image_converter</b> - 포맷 변환</summary>

지원 포맷: .png, .jpg, .jpeg, .webp, .gif, .bmp

</details>

<details> <summary><b>gasio_favicon_generator</b> - 파비콘 생성</summary>

생성 파일: favicon.ico, favicon-16x16.png, favicon-32x32.png, favicon-48x48.png, apple-touch-icon.png, android-chrome-192x192.png, android-chrome-512x512.png, site.webmanifest

</details>

<details> <summary><b>gasio_exif_cleaner</b> - EXIF 메타데이터 제거</summary>

</details>

<details> <summary><b>gasio_png_to_svg</b> - SVG 변환</summary>

</details>

<details> <summary><b>gasio_video_to_gif</b> - GIF 변환</summary>

</details>

<details> <summary><b>gasio_audio_cut</b> - 오디오 편집</summary>

</details>

<details> <summary><b>gasio_screenshot_mockup</b> - 스크린샷 목업</summary>

</details>

<details> <summary><b>gasio_image_to_text_ocr</b> - OCR 텍스트 추출</summary>

npm run setup (또는 npx gasio-mcp-setup) 실행 후 사용 가능합니다.

</details>

<details> <summary><b>gasio_qrcode_generator</b> - QR 코드 생성</summary>

</details>

<details> <summary><b>gasio_css_generator</b> - CSS 코드 생성</summary>

파일 저장 없이 CSS 코드와 HTML 스니펫을 텍스트로 즉시 반환합니다.

</details>

🔒 보안 정책

• Path Traversal 차단: 모든 입력 경로는 홈 디렉토리 또는 시스템 임시 폴더 내로만 제한됩니다. ../ 참조는 즉시 차단됩니다.
• stdout 보호: MCP 프로토콜의 JSON-RPC 통신 채널(stdout)에 로그를 출력하지 않으며, 모든 로그는 stderr로만 전송됩니다.
• 네트워크 격리: 모든 처리는 사용자의 로컬 머신에서만 수행되며, 어떠한 파일도 외부 서버로 전송되지 않습니다.

🛠️ 개발자용: 로컬 빌드

git clone https://github.com/kimhoecheon-cmd/gasio-tools-site.git
cd gasio-tools-site/gasio-mcp-server
npm install
npm run build    # TypeScript 컴파일
npm run setup    # AI 모델 다운로드
npm start        # 서버 시작 (stdio 대기)

🌐 관련 서비스

📄 라이선스

MIT License © Gasio Tools

gasiotools-mcp