leeshfield MCP

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

• 엔드포인트: https://leeshfield-mcp.klr.kr/mcp

• 인증: OAuth 2.1 — 최초 연결 시 브라우저에서 leeshfield 로그인 후 동의하면 끝. 클라이언트 사전 등록 불필요(동적 등록·PKCE·토큰 갱신 전부 자동).

• 모든 작업은 로그인한 사용자 권한 범위 안에서만 실행된다.

툴

로컬 파일 업로드

MCP 도구 인자는 JSON이라 파일 바이트를 실으려면 base64여야 하고, 그 문자열은 모델 컨텍스트를 그대로 지나간다(원본의 약 1.33배). 그래서 로컬 파일은 upload_asset이 아니라 서명 URL 2단계를 쓴다 — 바이트가 모델도 MCP 서버도 거치지 않고 저장소로 직행한다.

1. create_upload_url({ name, mimeType, sizeBytes })   → uploadUrl, objectKey
2. curl -sS -X PUT -H "Content-Type: <mimeType>" \
        --data-binary @<파일경로> "<uploadUrl>"        ← 셸에서 실행
3. complete_upload({ objectKey, name })               → assetId, handle

서버는 2단계로 올라온 바이트에서 sha256·형식(매직넘버)·해상도·길이를 직접 계산해 정책을 검증한다. 선언한 Content-Type이 실제 내용과 다르면 등록이 거부된다. 2단계까지만 하고 3단계를 부르지 않은 업로드는 temp/에 남으며 정리 대상이다 (leeshfield docs/storage-retention.md 참고).

upload_asset은 원격 URL에서 가져올 때, 또는 셸이 없는 환경에서 아주 작은 파일을 올릴 때만 쓴다.

프롬프트 형식이 고정된 모델

minimax-h3는 자유 서술 프롬프트를 받지 않는다. 섹션 헤더가 붙은 고정 스키마를 요구한다.

get_prompt_guide로 가이드 원문(+ leeshfield 적용 제약)을 받아 그대로 작성하면 된다. 형식을 벗어난 프롬프트는 generate_video가 공급자에 보내기 전에 거부하므로 크레딧이 낭비되지 않는다. 원문은 docs/minimax_h3/에 있다.

Related MCP server: creatify-mcp

클라이언트 연결

표준 OAuth를 지원하는 MCP 클라이언트라면 아래에 없어도 URL만 넣으면 연결된다.

Claude Code

claude mcp add --transport http leeshfield https://leeshfield-mcp.klr.kr/mcp
# 이후 세션에서 /mcp 명령으로 인증 상태 확인·재로그인

claude.ai / Claude Desktop (커넥터)

설정 → 커넥터(Connectors) → 커스텀 커넥터 추가 → URL에 https://leeshfield-mcp.klr.kr/mcp 입력 → 연결 시 브라우저 인증.

Codex CLI

~/.codex/config.toml:

[mcp_servers.leeshfield]
url = "https://leeshfield-mcp.klr.kr/mcp"
# 구버전 Codex에서 url 방식이 안 되면 아래 플래그를 함께 켠다
# experimental_use_rmcp_client = true

codex mcp login leeshfield   # 브라우저 OAuth 로그인

네이티브 HTTP 지원이 없는 구버전이면 stdio 브리지로 등록한다:

[mcp_servers.leeshfield]
command = "npx"
args = ["-y", "mcp-remote", "https://leeshfield-mcp.klr.kr/mcp"]

Cursor

~/.cursor/mcp.json (또는 프로젝트 .cursor/mcp.json):

{
  "mcpServers": {
    "leeshfield": { "url": "https://leeshfield-mcp.klr.kr/mcp" }
  }
}

VS Code (Copilot)

.vscode/mcp.json:

{
  "servers": {
    "leeshfield": { "type": "http", "url": "https://leeshfield-mcp.klr.kr/mcp" }
  }
}

Gemini CLI

~/.gemini/settings.json:

{
  "mcpServers": {
    "leeshfield": { "httpUrl": "https://leeshfield-mcp.klr.kr/mcp" }
  }
}

OAuth를 지원하지 않는 클라이언트 (stdio 브리지)

Streamable HTTP나 OAuth를 모르는 클라이언트는 mcp-remote를 stdio 서버로 등록하면 된다 — 브리지가 브라우저 로그인·토큰 갱신을 대신 처리한다.

{
  "mcpServers": {
    "leeshfield": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://leeshfield-mcp.klr.kr/mcp"]
    }
  }
}

연결 디버깅

npx @modelcontextprotocol/inspector
# Transport: Streamable HTTP, URL: https://leeshfield-mcp.klr.kr/mcp → Open Auth로 로그인

클라이언트 호환성