Claude Code에서 AI 이미지, 오디오, 동영상 생성 — lweight MCP 서버 소개

Claude Code 터미널에서 XBRUSH AI 이미지를 생성하고 inblog에 바로 발행하는 MCP 서버 2종을 소개합니다. 개발자 워크플로우에 AI 이미지 생성을 통합하는 방법을 설명합니다.

Mar 31, 2026

Contents

Claude Code에서 AI 이미지·오디오·동영상 생성 — lweight MCP 서버 소개 (2026)MCP란 무엇인가 lweight MCP 서버 — 두 가지 핵심 서버 xbrush-api-mcp 기능 목록 이미지 생성 및 편집 (4가지)오디오 생성 동영상 생성 유틸리티 도구 (5가지)다른 이미지 생성 MCP 서버와의 비교 설정 방법 실제 활용 예시 — 블로그 포스트 자동화 MCP 생태계 현황 — 2026년 기준 Claude Code에서 MCP 활용하기 — 기본 명령 xbrush-api-mcp 실전 활용 — 이미지 생성부터 블로그 발행까지 비동기 작업 처리 패턴 보안과 API 키 관리 이런 상황에 사용하세요 사용 도구 관련 글 자주 묻는 질문 Claude Code 없이도 xbrush-api-mcp를 사용할 수 있나요?비동기 작업은 어떻게 처리하나요?이미지 1장 생성 비용이 얼마인가요?xbrush-api-mcp와 inblog-mcp를 동시에 사용할 수 있나요?오픈소스인가요? 직접 수정할 수 있나요?

Claude Code에서 AI 이미지·오디오·동영상 생성 — lweight MCP 서버 소개 (2026)

AI 콘텐츠 생성을 코딩 워크플로우에 통합하고 싶지만, 매번 브라우저를 열고 플랫폼에 로그인하는 과정이 번거롭다는 것을 느낀 적 있습니다. Claude Code에서 직접 이미지를 생성하고, inblog 블로그에 발행까지 처리하는 MCP 서버를 구축해봤습니다.

한눈에 보기: lweight MCP는 XBRUSH AI 이미지·오디오·동영상 생성과 inblog 블로그 발행을 Claude Code 터미널에서 직접 호출할 수 있게 해주는 오픈소스 MCP 서버 패키지입니다. Node.js 18 이상과 XBRUSH API 키만 있으면 설치할 수 있습니다.

Anthropic이 2024년 11월 공개한 MCP(Model Context Protocol) 생태계는 2026년 현재 급속도로 성장하고 있습니다. According to Anthropic's official MCP documentation, the protocol is designed to be a universal open standard for connecting AI models to external tools and data sources — an "AI의 USB-C 포트"라고 표현할 수 있습니다.

MCP란 무엇인가

한눈에 보기: MCP(Model Context Protocol)는 Anthropic이 공개한 오픈 표준 프로토콜로, AI 어시스턴트가 외부 도구·API·데이터에 직접 접근할 수 있도록 연결합니다. Claude Code, Claude Desktop 등에서 MCP 서버를 통해 다양한 외부 서비스를 호출할 수 있습니다.

MCP 이전에는 AI 어시스턴트가 외부 API를 호출하려면 각 서비스마다 별도의 플러그인이나 커스텀 통합이 필요했습니다. MCP는 이 문제를 해결합니다. 표준화된 프로토콜로 MCP 서버를 한 번 구축하면, Claude Code뿐 아니라 MCP를 지원하는 모든 AI 클라이언트에서 동일하게 활용할 수 있습니다.

According to the MCP specification published on modelcontextprotocol.io, any MCP-compliant server can expose tools, resources, and prompts that any MCP-compliant client can discover and use — enabling a growing open ecosystem of integrations. 현재 수천 개의 MCP 서버가 커뮤니티에 의해 개발·공유되고 있습니다.

lweight MCP 서버 — 두 가지 핵심 서버

한눈에 보기: lweight MCP 패키지는 두 개의 서버로 구성됩니다. xbrush-api-mcp는 AI 콘텐츠 생성을, inblog-mcp는 블로그 발행을 담당합니다. 이 두 서버를 조합하면 프롬프트 입력부터 블로그 발행까지 Claude Code 하나로 완결됩니다.

서버	담당 기능	주요 대상	라이선스
xbrush-api-mcp	AI 이미지·오디오·동영상 생성 및 편집	개발자, 콘텐츠 자동화	MIT
inblog-mcp	inblog 블로그 글 작성·발행·관리	마케터, 블로거	MIT

xbrush-api-mcp 기능 목록

한눈에 보기: xbrush-api-mcp는 텍스트→이미지 생성, 인페인팅 편집, 업스케일, 배경 제거, 텍스트→음성, 이미지→동영상, AI 모델 립싱크 영상 생성 등 총 9가지 도구를 제공합니다. 이미지 생성은 동기 처리, 편집 작업은 비동기 처리로 구분됩니다.

이미지 생성 및 편집 (4가지)

텍스트→이미지 생성: 프롬프트 입력 시 즉시 이미지 반환 (동기 처리). XBRUSH의 9개+ AI 엔진 중 선택 가능.
텍스트 지시 편집 (인페인팅): 이미지 URL과 편집 지시를 넘기면 비동기로 처리. 작업 ID를 반환하며 상태 조회 도구로 완료 확인.
이미지 업스케일: 해상도 향상. 비동기 처리.
배경 제거: 자동 배경 분리. 비동기 처리.

오디오 생성

텍스트→음성 합성 (TTS): 텍스트를 음성으로 변환. 음성 스타일 커스터마이징 지원.

동영상 생성

이미지→동영상 변환: 정지 이미지에 자연스러운 움직임 적용.
AI 모델 립싱크 영상 (XBRUSH 광고 스튜디오): AI 가상 모델에 음성을 합성해 립싱크 광고 영상 제작.

유틸리티 도구 (5가지)

AI 엔진 모델 목록 조회
비동기 작업 상태 조회
요청 이력 조회
파일 업로드
API 상태 확인

다른 이미지 생성 MCP 서버와의 비교

한눈에 보기: 현재 MCP 생태계에는 다양한 이미지 생성 서버가 있습니다. xbrush-api-mcp는 단일 엔진이 아닌 9개+ AI 엔진 통합, 이미지뿐 아니라 오디오·동영상까지 아우르는 멀티모달 지원, 그리고 블로그 발행까지 연결되는 워크플로우 통합이 차별점입니다.

항목	xbrush-api-mcp	단일 엔진 이미지 MCP	Stability AI MCP 류
AI 엔진 수	9개+ (통합)	1개	1개 (Stable Diffusion 계열)
지원 콘텐츠 유형	이미지·오디오·동영상	이미지만	이미지 위주
편집 기능 (인페인팅)	있음	없거나 제한적	있음
블로그 발행 통합	inblog-mcp 연동	없음	없음
비동기 처리	있음 (작업 ID 반환)	없음 (동기만)	경우에 따라 다름
이미지 1장 비용	$0.01	서버마다 다름	$0.02~$0.04 수준
라이선스	MIT (오픈소스)	서버마다 다름	서버마다 다름

설정 방법

한눈에 보기: xbrush.run에서 API 키를 발급받은 뒤 Claude Code MCP 설정 파일에 서버 정보와 API 키를 추가하면 됩니다. Node.js 18 이상이 설치된 환경이면 추가 의존성 없이 즉시 사용할 수 있습니다.

설치는 세 단계로 완료됩니다.

1단계: API 키 발급
xbrush.run에 접속해 계정을 만들고 API 키를 발급받습니다. XBRUSH 서비스와 동일한 계정을 사용합니다.

2단계: Claude Code MCP 설정
Claude Code의 MCP 설정 파일 (~/.claude/settings.json 또는 프로젝트 로컬 설정)에 아래 내용을 추가합니다.

{
  "mcpServers": {
    "xbrush-api-mcp": {
      "command": "npx",
      "args": ["-y", "@lweight/xbrush-api-mcp"],
      "env": {
        "XBRUSH_API_KEY": "your-api-key-here"
      }
    },
    "inblog-mcp": {
      "command": "npx",
      "args": ["-y", "@lweight/inblog-mcp"],
      "env": {
        "INBLOG_API_KEY": "your-inblog-api-key-here"
      }
    }
  }
}

3단계: Claude Code 재시작
설정 저장 후 Claude Code를 재시작하면 MCP 서버가 자동으로 연결됩니다. /mcp 명령으로 연결된 서버와 사용 가능한 도구 목록을 확인할 수 있습니다.

요구사항: Node.js 18 이상, Claude Code, XBRUSH API 키. 자세한 설정은 XBRUSH 문서를 참고하세요.

실제 활용 예시 — 블로그 포스트 자동화

한눈에 보기: xbrush-api-mcp와 inblog-mcp를 조합하면 "이미지 생성 → 글 초안 작성 → 블로그 발행"을 Claude Code 하나로 처리할 수 있습니다. Playwright MCP와 함께 사용하면 외부 콘텐츠 수집과 이미지 생성을 연결하는 자동화 파이프라인도 구축 가능합니다.

실제로 이 블로그의 일부 포스트는 xbrush-api-mcp와 inblog-mcp를 함께 사용해 작성됐습니다. 워크플로우는 다음과 같습니다.

Claude Code에서 포스트 기획 및 초안 작성
xbrush_generate_image 도구로 대표 이미지 생성
inblog_create_post 도구로 초안과 이미지를 함께 블로그에 업로드
inblog_publish_post 도구로 발행

이 과정에서 브라우저를 열 필요가 없습니다. 프롬프트를 수정하고 재생성하는 반복 작업도 터미널에서 모두 처리됩니다.

Playwright MCP를 추가로 연결하면, 특정 URL에서 정보를 수집 → 이미지 생성 → 블로그 발행의 자동화 파이프라인도 구성할 수 있습니다. 실제 이 저장소의 작업 중 일부가 그 방식으로 운영되고 있습니다.

AI 이미지 생성 자동화에 대한 더 깊은 내용은 AI 워크플로우 vs 프롬프트 포스트를 참고하세요.

MCP 생태계 현황 — 2026년 기준

한눈에 보기: Anthropic이 2024년 11월 MCP를 공개한 이후, 생태계는 급속도로 확장됐습니다. 2026년 현재 수천 개의 커뮤니티 MCP 서버가 GitHub에 공개돼 있으며, Google, Microsoft, Notion, GitHub 등 주요 플랫폼이 공식 MCP 서버를 제공하고 있습니다.

According to Anthropic's State of MCP report (early 2026), more than 3,000 MCP servers have been published to the community since the protocol's launch, spanning categories from developer tools and productivity platforms to creative generation and data analysis. AI 개발자 워크플로우의 표준 인터페이스로 자리잡는 중입니다.

현재 MCP 생태계의 주요 카테고리는 다음과 같습니다.

개발자 도구: GitHub MCP, GitLab MCP, Sentry MCP (코드 저장소 및 오류 추적)
생산성: Notion MCP, Google Drive MCP, Slack MCP (문서·커뮤니케이션)
데이터·분석: PostgreSQL MCP, BigQuery MCP (데이터베이스 직접 쿼리)
크리에이티브 생성: xbrush-api-mcp (이미지·오디오·동영상)
퍼블리싱: inblog-mcp (블로그 발행 자동화)

xbrush-api-mcp는 크리에이티브 생성 카테고리에서 멀티모달(이미지+오디오+동영상)을 단일 서버로 커버하는 드문 사례입니다. 대부분의 이미지 생성 MCP 서버가 단일 엔진, 이미지 생성만 지원하는 것과 대조적입니다.

Claude Code에서 MCP 활용하기 — 기본 명령

한눈에 보기: Claude Code에서 MCP 서버를 사용할 때 알아두면 편한 기본 명령이 있습니다. /mcp로 연결 상태를 확인하고, 자연어로 도구를 호출하거나 명시적으로 도구 이름을 지정해 사용할 수 있습니다.

MCP 설정을 완료하고 Claude Code를 재시작한 뒤, 실제로 어떻게 사용하는지 간단한 예시입니다.

연결 확인

/mcp

연결된 MCP 서버 목록과 각 서버에서 사용 가능한 도구 이름이 표시됩니다.

이미지 생성 예시 (자연어)

xbrush-api-mcp로 "봄 분위기 화장품 제품 사진, 흰 배경, 꽃 소품" 이미지를 생성해줘.

인페인팅 편집 예시

다음 이미지 URL의 배경을 "대리석 테이블 위, 자연광"으로 바꿔줘:
https://raw.githubusercontent.com/.../product-01.jpg

블로그 발행 예시

inblog-mcp로 아래 내용을 블로그에 초안으로 저장해줘.
제목: [제목]
본문: [HTML 본문]
대표 이미지: [이미지 URL]

Claude Code는 자연어 지시를 분석해 적절한 MCP 도구를 선택하고 호출합니다. 도구 이름을 직접 지정하지 않아도 문맥에서 적절한 도구를 찾아 사용합니다.

xbrush-api-mcp 실전 활용 — 이미지 생성부터 블로그 발행까지

한눈에 보기: xbrush-api-mcp와 inblog-mcp를 함께 사용하면 Claude Code 세션 하나에서 이미지 생성, 포스트 작성, 블로그 발행을 순서대로 처리할 수 있습니다. 각 단계에서 사용되는 도구와 실제 호출 예시를 정리했습니다.

이 블로그의 일부 포스트는 다음 워크플로우로 작성됐습니다. Claude Code 세션을 열고 이 순서대로 진행했습니다.

Step 1. 포스트 기획 및 초안 작성
Claude Code에서 포스트 주제와 구조를 정하고 HTML 초안을 작성합니다. 이 단계는 MCP와 무관하게 Claude Code의 일반 기능을 사용합니다.

Step 2. 대표 이미지 생성

xbrush-api-mcp의 generate_image 도구로 이미지를 생성해줘.
프롬프트: "Claude Code terminal with AI image generation workflow diagram, clean dark background, code editor aesthetic"
엔진: 기본값 사용

동기 처리이므로 즉시 이미지 URL이 반환됩니다. 이 URL을 바로 다음 단계에서 사용합니다.

Step 3. 블로그 초안 생성

inblog-mcp의 create_post 도구로 초안을 저장해줘.
blogId: 11170 (영문 블로그)
title: "AI Image Generation in Claude Code — Introducing lweight MCP Server (2026)"
content_html: [HTML 본문]
image: [Step 2에서 생성된 이미지 URL]

Step 4. 발행

inblog-mcp의 publish_post 도구로 발행해줘.
postId: [create_post에서 반환된 ID]

Step 1을 제외하면 모두 2~3줄의 지시로 처리됩니다. 이 블로그에 발행된 포스트 중 상당수가 이 워크플로우로 작성됐습니다.

AI 이미지 생성 자동화와 워크플로우 파이프라인의 개념에 대해서는 AI 워크플로우 vs 프롬프트 포스트에서 더 자세히 다룹니다.

비동기 작업 처리 패턴

한눈에 보기: 인페인팅, 업스케일, 배경 제거 등 처리 시간이 필요한 작업은 비동기로 처리됩니다. 작업 ID를 받아 상태를 조회하는 패턴을 알아두면 Claude Code에서 자동화 파이프라인을 구성할 때 유용합니다.

비동기 도구를 호출하면 즉시 결과를 반환하지 않고 작업 ID를 반환합니다. 이후 상태 조회 도구로 완료 여부를 확인합니다.

# 1. 인페인팅 요청 (비동기)
# → 즉시 작업 ID 반환
task_id = xbrush_edit_image(
  image_url="https://...",
  prompt="배경을 대리석 테이블로 교체"
)

# 2. 상태 조회
# → 완료되면 결과 이미지 URL 반환
result = check_task_status(task_id=task_id)

Claude Code에서 "작업이 완료될 때까지 기다려줘"라고 지시하면, 자동으로 일정 간격으로 상태를 조회하고 완료 후 결과를 알려줍니다. 수동으로 폴링 로직을 작성하지 않아도 됩니다.

복수의 비동기 작업을 병렬로 실행하고 싶다면, 여러 작업을 한꺼번에 요청한 뒤 각 task_id를 순서대로 조회하면 됩니다. 배치 이미지 편집 작업에 유용한 패턴입니다.

보안과 API 키 관리

한눈에 보기: MCP 설정 파일에 API 키를 직접 입력하면 편리하지만, 공유 환경에서는 환경변수나 비밀 관리 도구를 사용하는 것이 안전합니다. Claude Code MCP 설정에서 환경변수를 참조하는 방법을 지원합니다.

Claude Code MCP 설정 파일은 로컬 머신에만 저장되므로 개인 환경에서는 API 키를 직접 입력해도 문제없습니다. 그러나 팀 환경이나 설정 파일을 버전 관리에 포함하는 경우에는 환경변수를 사용하는 것이 권장됩니다.

# .env 또는 셸 환경변수 설정
export XBRUSH_API_KEY="your-api-key-here"
export INBLOG_API_KEY="your-inblog-api-key-here"

설정 파일에서 환경변수를 참조하면 API 키가 설정 파일에 하드코딩되지 않습니다. Git 저장소에 설정 파일을 커밋할 때 API 키가 노출되는 것을 방지합니다.

XBRUSH API 키는 xbrush.run 대시보드에서 언제든지 재발급하거나 폐기할 수 있습니다. 키가 노출됐다고 판단될 경우 즉시 폐기하고 새 키를 발급하세요.

이런 상황에 사용하세요

Claude Code에서 AI 이미지를 바로 생성해 문서나 블로그에 삽입하고 싶을 때
콘텐츠 제작 파이프라인을 자동화하려는 개발자
inblog 블로그를 사용하는 마케터 — 글 작성부터 발행까지 터미널에서 처리
반복적인 이미지 배치 생성이 필요한 프로젝트
MCP 기반 AI 자동화 워크플로우를 탐색하는 엔지니어

사용 도구

xbrush-api-mcp — AI 콘텐츠 생성 (github.com/lweight/xbrush-api-mcp)
inblog-mcp — 블로그 발행 자동화 (github.com/lweight/inblog-mcp)
XBRUSH API (xbrush.run)

자주 묻는 질문

Claude Code 없이도 xbrush-api-mcp를 사용할 수 있나요?

MCP를 지원하는 모든 클라이언트에서 사용할 수 있습니다. Claude Desktop, Cursor, Continue 등 MCP 표준을 구현한 환경이라면 동일하게 동작합니다. 설정 파일 형식은 클라이언트마다 다를 수 있으니 각 클라이언트의 MCP 설정 방법을 확인하세요.

비동기 작업은 어떻게 처리하나요?

인페인팅, 업스케일, 배경 제거 등 처리 시간이 필요한 작업은 비동기로 처리됩니다. 작업 요청 시 작업 ID가 반환되며, check_task_status 도구로 완료 여부를 확인할 수 있습니다. Claude Code에서는 작업 완료를 기다리도록 지시하면 자동으로 폴링합니다.

이미지 1장 생성 비용이 얼마인가요?

XBRUSH API를 통한 이미지 생성은 장당 $0.01입니다. Basic 플랜($7/월)에 포함된 크레딧을 사용하거나, Pay-as-you-go 방식으로 사용량만큼만 비용이 청구됩니다. XBRUSH 요금제에서 상세 내용을 확인할 수 있습니다.

xbrush-api-mcp와 inblog-mcp를 동시에 사용할 수 있나요?

네. 두 서버를 Claude Code MCP 설정에 함께 등록하면 동시에 사용할 수 있습니다. 이미지 생성 후 즉시 블로그에 업로드하는 워크플로우가 대표적인 활용 사례입니다.

오픈소스인가요? 직접 수정할 수 있나요?

네. xbrush-api-mcp와 inblog-mcp 모두 MIT 라이선스 오픈소스입니다. github.com/lweight 에서 소스코드를 확인하고, 필요에 따라 포크하거나 수정해 사용할 수 있습니다. 기여(PR)도 환영합니다.

Last updated: 2026-04-15 · Node.js 18+, Claude Code, XBRUSH API 키 필요. MCP 설정 방법은 각 클라이언트 문서를 참고하세요.

Contents