Imagor MCP는 이미지 처리 서버 imagor에 템플릿 기능을 더하는 MCP 서버와 스킬이다. 에이전트가 소셜 미디어 카드, 상품 그리드, 인용문, 후기 등의 레이아웃을 작성하면 imagor URL 하나로 변환하고, 이미 실행 중인 imagor가 이를 렌더링한다.
- 먼저 imagor를 실행한다. 아래 명령은 시험용 안전하지 않은 모드로 실행한다.
bash
docker run --rm -p 8000:8000 shumc/imagor -imagor-unsafe
- 두 번째 터미널에서 MCP 서버를 설치한다.
bash
brew trust cshum/tap && brew install imagor-mcp
- 사용하는 클라이언트에 서버를 연결한다. VS Code는 설치 링크에서 추가할 수 있고, Claude Desktop은 imagor-mcp.mcpb를 열어 설치한다. Cursor, Claude Code, Windsurf에서는 설정 파일에 다음 내용을 추가한다.
json
{
"mcpServers": {
"imagor": {
"command": "imagor-mcp",
"env": { "IMAGOR_UNSAFE": "1", "IMAGOR_BASE_URL": "http://localhost:8000" }
}
}
}
IMAGOR_UNSAFE와 IMAGOR_BASE_URL은 앞서 실행한 imagor 설정과 일치해야 한다. 위 설정은 VS Code와 Codex 형식에 맞지 않는다. 각 클라이언트별 설정은 Setup 안내에서 확인할 수 있다.
설정 후 원하는 이미지를 설명하거나 Cookbook의 예시 프롬프트를 사용하면 된다. 에이전트가 레이아웃을 작성하고 렌더링 결과를 확인한 뒤 URL을 반환한다. 도구가 imagor 경로를 구성하고 실행할 수 없는 경로는 거부하므로, 사용자가 imagor의 경로 문법을 직접 다룰 필요는 없다.
-imagor-unsafe는 시험용이다. 공개 환경에서 사용하기 전에는 보안 안내를 확인해야 한다. 이 도구는 공식 MCP Registry에서 io.github.cshum/imagor-mcp라는 이름으로도 제공되며, 컨테이너 이미지 ghcr.io/cshum/imagor-mcp를 사용할 수도 있다. 컨테이너 방식은 기본 URL 설정이 달라진다. Windows 바이너리는 릴리스 페이지에서 제공된다.
그 밖에 서버의 도구와 레이아웃 형식은 Reference, 기여 방법은 Contributing에서 확인할 수 있다. 라이선스는 MIT다.
댓글 (0)
로그인하면 이 기사에 내 생각을 남길 수 있어요