Kairogen MCP

Kairogen을 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. Claude, Cursor, ChatGPT(커스텀 커넥터), Hermes, OpenClaw 또는 MCP 호환 에이전트를 연결하고 Kairogen의 전체 모델 카탈로그(Seedream, Flux, Nano Banana, GPT Image, Sora, Veo, Kling, Seedance, KairoClone, Topaz)를 사용하여 이미지와 비디오를 생성하세요.

인증은 OAuth 2.0 방식을 사용합니다. 복사하거나 교체해야 할 API 키가 없습니다.

30초 만에 연결하기

Claude.ai (커스텀 커넥터)

1. 설정(Settings) → 커넥터(Connectors) → 커스텀 커넥터 추가(Add custom connector)

2. URL: https://mcp.kairogen.ai/mcp

3. 연결(Connect) 클릭 → Kairogen으로 로그인 → 승인

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "kairogen": {
      "url": "https://mcp.kairogen.ai/mcp"
    }
  }
}

Cursor를 재시작하고 메시지가 표시되면 연결(Connect)을 클릭하세요.

ChatGPT (커스텀 커넥터)

설정(Settings) → 커넥터(Connectors) → 새 커스텀 커넥터 추가(New custom connector) → https://mcp.kairogen.ai/mcp를 붙여넣으세요. ChatGPT가 요청하면 로그인하세요.

Claude Code

claude mcp add --transport http kairogen https://mcp.kairogen.ai/mcp

원격 OAuth 보호 MCP 서버의 경우 --transport http 플래그가 필수입니다. 이 플래그가 없으면 CLI는 stdio로 간주하여 URL을 로컬 바이너리로 실행하려고 시도합니다.

Hermes / OpenClaw / NemoClaw (채팅 전용 에이전트)

에이전트에 다음 프롬프트를 붙여넣으세요:

Connect the Kairogen MCP at https://mcp.kairogen.ai/mcp. It supports OAuth device flow,
discovery at https://mcp.kairogen.ai/.well-known/oauth-protected-resource. Run the device
flow and reply with: Authorize here: https://app.kairogen.ai/device?code=XXXX-XXXX. Then
poll the token endpoint until I authorize and confirm once it succeeds.

에이전트가 링크로 응답할 것입니다. 링크를 열고 'Permitir acesso'(액세스 허용)를 클릭하면 연결됩니다.

로컬 stdio (Claude Desktop, 헤드리스 개발, 오프라인)

{
  "mcpServers": {
    "kairogen": {
      "command": "npx",
      "args": ["-y", "@kairogen/mcp"]
    }
  }
}

처음 실행 시 CLI는 OAuth 기기 흐름을 실행하고 브라우저를 열며, 토큰을 ~/.kairogen/tokens.json에 자동 갱신 기능과 함께 캐시합니다. 환경 변수는 필요하지 않습니다.

도구

모든 generate_* 도구는 wait_for_completion: false를 지원하여 generation_id를 즉시 반환하고 get_generation을 통해 폴링할 수 있게 합니다. 폴링 중 5초마다 MCP notifications/progress 하트비트를 전송하므로 Claude Desktop / Cursor 등에서 실시간 진행률 표시줄이 나타나며 렌더링 도중 연결이 끊기지 않습니다.

구성

환경 변수(모두 선택 사항이며 적절한 기본값이 설정되어 있음):

로컬 개발

git clone https://github.com/kairogenai/kairogen-mcp.git
cd kairogen-mcp
npm install
npm run build

# stdio mode (with OAuth device flow on first run):
node dist/stdio.js

# remote HTTP mode (validates Bearer tokens against api.kairogen.ai/.well-known/jwks.json):
PORT=8080 node dist/http.js

스모크 테스트 (에이전트 불필요):

KAIROGEN_API_KEY=eyJ... node -e "
const init = JSON.stringify({jsonrpc:'2.0',id:1,method:'initialize',params:{protocolVersion:'2025-11-25',capabilities:{},clientInfo:{name:'smoke',version:'0'}}});
const initd = JSON.stringify({jsonrpc:'2.0',method:'notifications/initialized'});
const list = JSON.stringify({jsonrpc:'2.0',id:2,method:'tools/list'});
process.stdout.write(init+'\\n'+initd+'\\n'+list+'\\n');
" | node dist/stdio.js

배포 (mcp.kairogen.ai)

fly launch --no-deploy --copy-config --name kairogen-mcp
fly secrets set \
  MCP_RESOURCE=https://mcp.kairogen.ai \
  OAUTH_ISSUER=https://api.kairogen.ai \
  OAUTH_AUDIENCE=kairogen-api \
  MCP_AUTH_SERVERS=https://api.kairogen.ai \
  KAIROGEN_API_BASE=https://api.kairogen.ai
fly deploy
fly certs add mcp.kairogen.ai

MCP_AUTH_SERVERS가 필요합니다. 이는 MCP 클라이언트가 OAuth 흐름을 실행할 위치를 찾는 방법인 /.well-known/oauth-protected-resource의 authorization_servers 필드를 채웁니다. 여러 발급자가 필요한 경우 쉼표로 구분하세요.

OAuth 발급자가 필요한 백엔드 환경 변수

인증 서버(kairogen-backend-development)는 자체 배포 환경에 다음 설정이 필요합니다:

DNS: mcp.kairogen.ai(CNAME)를 Fly 앱 호스트 이름으로 지정하세요.

아키텍처

• 프론트엔드(kairogen-frontend-development)는 /oauth/consent, /device, /settings/connections에서 동의 화면을 호스팅합니다.

• 백엔드(kairogen-backend-development)는 OAuth 발급자입니다. /.well-known/oauth-authorization-server, /.well-known/jwks.json, /oauth/authorize/approve, /oauth/token, /oauth/device_authorization, /oauth/device/approve, /oauth/connections를 마운트합니다.

• MCP 서버(본 저장소)는 리소스 서버입니다. 백엔드에서 발행한 Bearer JWT를 게시된 JWKS에 대해 검증한 후, 사용자의 토큰을 사용하여 api.kairogen.ai로 도구 호출을 프록시합니다.

로드맵

• [x] v0.1 stdio + sAccessToken 붙여넣기 (사용 중단)

• [x] v0.2 stdio 첫 실행 시 OAuth 기기 흐름

• [x] v0.3 mcp.kairogen.ai에서 호스팅되는 Streamable HTTP

• [ ] v0.4 리소스 (kairogen://models, kairogen://prompt-guide/{model})

• [ ] v0.5 마케팅 스튜디오 + 시네마 컨트롤 흐름을 상위 수준 도구로 제공

라이선스

MIT