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 强制执行。

• 无状态 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 本体。