claude-foundry-image

Claude Code 플러그인으로, 모든 프로젝트와 모든 대화에 Azure AI Foundry 배포(MAI 이미지 API, 예: MAI-Image-2.5-Pro)를 기반으로 하는 이미지 생성기를 제공합니다.

• MCP 서버 (server/server.mjs) — Node ≥ 18, 제로 의존성. 도구: generate_image, edit_image, check_config.

• 스킬 generate-image — Claude가 도구를 사용해야 할 시점, 한 줄짜리 요청을 사용 가능한 프롬프트로 확장하는 방법, 유효한 크기, 파일을 저장할 위치를 알려줍니다.

• 스킬 setup — 일회성 설정 안내.

이미지는 디스크에 저장되며, 파일 경로만 대화에 포함됩니다. 컨텍스트에 base64는 없습니다.

설치

claude plugin marketplace add jpaarhuis/claude-foundry-image

claude plugin install foundry-image@jpaarhuis

또는 대화형 세션에서: /plugin → 마켓플레이스 → jpaarhuis/claude-foundry-image 추가 → foundry-image 설치.

Related MCP server: gpt-image-mcp

설정 (한 번만)

서버는 환경 변수에서 설정을 읽습니다. ~/.claude/settings.json의 env 아래에 넣으세요. — 하나의 파일, 모든 플랫폼, Claude Code만 볼 수 있습니다:

{
  "env": {
    "MAI_IMAGE_ENDPOINT": "https://<resource>.services.ai.azure.com/mai/v1/images/generations",
    "MAI_IMAGE_DEPLOYMENT": "MAI-Image-2.5-Pro",
    "MAI_IMAGE_API_KEY": "<key>",
    "MAI_IMAGE_OUTPUT_DIR": "C:/Users/<you>/Pictures/ai"
  }
}

또는 OS 사용자 환경 변수로 설정하세요(Windows는 setx, macOS/Linux는 셸 프로필에서 export). 어느 쪽이든 Claude Code를 다시 시작하세요.

그런 다음 모든 세션에서: "run check_config" 또는 /foundry-image:setup을 실행하면 안내가 진행됩니다.

사용법

그냥 요청하세요: "README용 히어로 이미지 만들어줘, 어둡게, 아이소메트릭, 텍스트 없이". Claude가 프롬프트를 확장하고, 크기를 선택하고, PNG를 작성하여(저장소에 속하는 경우 저장소에) 경로를 반환합니다.

참고용 도구 매개변수:

MAI API의 크기 규칙: 각 변 ≥ 768 px, width × height ≤ 1 048 576 px. 따라서 1024x1024, 1024x768, 1280x800은 작동하지만 1024x1536과 1920x1080은 작동하지 않습니다.

왜 환경 변수이고 설정 파일이나 설정 대화상자가 아닌가요?

Claude Code 플러그인에는 플러그인별 비밀 저장소나 설정 UI가 없습니다. 공식 GitHub 플러그인이 PAT에 사용하는 것과 동일한 규칙인 ${VAR} 확장을 플러그인의 .mcp.json에서 사용하며, 사용자가 변수를 한 번 설정합니다. settings.json → env는 이를 위한 가장 마찰이 적은 장소입니다. Claude Code 프로필과 함께 이동하고, 모든 프로젝트에 적용되며, 플러그인 업데이트 후에도 유지됩니다.

키를 일반 텍스트 파일에서 빼내고 싶다면, 로그인 시 비밀 저장소(Key Vault, 1Password CLI, Windows Credential Manager)에서 환경으로 로드하세요. 서버는 변수가 어디서 왔는지 신경 쓰지 않습니다.

개발

npm test

오프라인 스모크 테스트를 실행합니다: MCP 핸드셰이크, 도구 목록, 크기 제한, 설정 누락 오류, 그리고 check_config가 키를 유출하지 않는지 확인합니다.

라이선스

MIT