leeshfield MCP

leeshfield(영상 생성 플랫폼)용 MCP(Model Context Protocol) 서버. AI 클라이언트(Claude 등)가 OAuth로 leeshfield 계정에 로그인해 자산을 추가하고, 이를 참조해 영상을 생성하고 결과를 반환받을 수 있다.

아키텍처

MCP 클라이언트 (Claude 등)
   │  Streamable HTTP + OAuth 2.1 (PKCE)
   ▼
leeshfield-mcp  ← 이 리포. 얇은 어댑터 (리소스 서버)
   │  Bearer 토큰 그대로 전달 (introspection으로 검증)
   ▼
leeshfield 본체  ← 인가 서버(/oauth/authorize, /api/oauth/*) + REST API

• 인가 서버는 leeshfield 본체다. 사용자 세션(로그인·동의 화면)이 그 도메인에 있기 때문. 이 서버는 RFC 9728 보호 리소스 메타데이터로 AS 위치만 알려준다.

• 이 서버는 자체 권한이 없다. 모든 툴 호출은 사용자 액세스 토큰을 leeshfield API에 그대로 전달하며, 워크스페이스 권한·테넌트 격리는 leeshfield가 강제한다.

• stateless Streamable HTTP — 세션 상태가 없어 재배포·다중 레플리카에 안전하다.

Related MCP server: creatify-mcp

툴

환경변수

개발

npm install
LEESHFIELD_URL=http://localhost:3000 MCP_PUBLIC_URL=http://localhost:3100 \
OAUTH_INTROSPECT_SECRET=dev PORT=3100 npm run dev

검증: npm run typecheck && npm run lint

클라이언트 연결

# Claude Code
claude mcp add --transport http leeshfield https://leeshfield-mcp.klr.kr/mcp

연결 시 브라우저가 열리며 leeshfield 로그인(Google/이메일) 후 동의 화면에서 허용하면 된다. 클라이언트 등록(DCR)·토큰 발급은 자동이다.

배포

• 브랜치: develop → dev(dev.leeshfield-mcp.klr.kr, 내부망 전용) / main → prod(leeshfield-mcp.klr.kr)

• Jenkins → OCI Registry → ArgoCD (gitops apps/leeshfield-mcp)

• dev MCP는 dev leeshfield(dev.leeshfield.klr.kr)를, prod는 prod 본체를 바라본다.