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本体を参照する。