text2img-mcp

텍스트 프롬프트로 AI 이미지를 생성하는 MCP 서버입니다. Google Gemini API를 사용하여 제안서, 인포그래픽, 차트 등 비즈니스용 이미지를 생성합니다.

Gemini 3.1 Flash Image Preview 모델 (gemini-3.1-flash-image-preview)을 사용합니다.

Gemini API 이미지 생성 공식문서를 참고하여 추천 프롬프트를 적용해보세요!

설치

1. 의존성 설치

# Windows - install.bat 더블클릭 또는 명령 프롬프트에서 실행
install.bat

# 또는 수동 설치
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt

2. Gemini API 키 발급

Google AI Studio에서 API 키를 발급받으세요.

3. Claude Desktop 설정

%APPDATA%\Claude\claude_desktop_config.json 파일에 추가:

{
  "mcpServers": {
    "text2img-mcp": {
      "command": "C:\\your-path\\text2img-mcp\\.venv\\Scripts\\python.exe",
      "args": ["C:\\your-path\\text2img-mcp\\server.py"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

C:\\your-path\\text2img-mcp 부분을 실제 설치 경로로 변경하세요. install.bat 실행 시 정확한 경로가 출력됩니다.

Claude Desktop을 재시작하면 도구를 사용할 수 있습니다.

MCP Tools

create_proposal_image

텍스트 프롬프트로 이미지를 생성합니다.

파라미터	타입	필수	설명
prompt	string	O	이미지 설명 텍스트
output_dir	string	X	저장 디렉토리 (기본: ~/Documents/text2img-mcp/images)
aspect_ratio	string	X	비율: 1:1, 16:9, 9:16, 4:3, 3:4 (기본: 1:1)

get_image_history

생성 이력을 조회합니다.

파라미터	타입	필수	설명
limit	int	X	조회 개수 (기본: 20)

사용 예시

Claude에게 다음과 같이 요청하세요:

• "2024년 매출 현황 인포그래픽 이미지 만들어줘"
• "프로젝트 일정 간트차트 이미지를 16:9 비율로 생성해줘"
• "이전에 만든 이미지 이력 보여줘"

요구사항

• Python 3.10+
• Gemini API Key