openai-image-mcp

OpenAI GPT Image API를 감싼 MCP 서버 (포니링크 IT사업본부). PPT/워드 문서 등에 삽입할 문맥에 맞는 이미지를 프롬프트로 생성하는 generate_image 도구 하나를 제공합니다.

로컬 스모크테스트

export OPENAI_API_KEY="sk-..."
node scripts/smoketest.js

tmp-output/smoketest.png에 생성된 이미지가 저장되면 정상 동작하는 것입니다. (저비용 옵션 quality: low, size: 1024x1024으로 호출하며, 실제 OpenAI API 과금이 발생합니다.)

Related MCP server: imagegen-mcp

Vercel 배포

1. GitHub 레포에 push한 뒤 Vercel에서 Import

2. 프로젝트 Settings > Environment Variables에 OPENAI_API_KEY 등록 (Production/Preview 모두)

3. 배포 완료 후 엔드포인트: https://<repo>.vercel.app/api/mcp

MCP 엔드포인트 직접 호출 (curl)

curl -s -X POST "https://<repo>.vercel.app/api/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

curl -s -X POST "https://<repo>.vercel.app/api/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc":"2.0","id":2,"method":"tools/call",
    "params":{
      "name":"generate_image",
      "arguments":{"prompt":"minimalist icon of a handshake, flat design","quality":"low"}
    }
  }'

claude.ai / Cowork에 연결

Settings > Connectors (또는 Capabilities) > "+" > Add custom connector 에서 https://<repo>.vercel.app/api/mcp 를 등록합니다.

인증

OPENAI_API_KEY 환경변수를 서버가 직접 들고 있으므로, 클라이언트(Claude)가 매 호출마다 키를 넘길 필요는 없습니다.

과금 안내

OpenAI 이미지 생성 API는 무료 티어가 없습니다. generate_image 호출 1회 = 실제 과금 1회입니다 (2026-08 기준 gpt-image-2, 1K 해상도 장당 약 $0.03 — 정확한 최신 가격은 OpenAI 공식 가격 페이지에서 확인).