@morit/plugin-mcp

Morit Plugin 개발 기능을 AI 에이전트에 제공하는 로컬 stdio MCP 서버입니다. manifest compiler, validation, light/dark preview, signing, Cloud Project sync와 Deployment는 SDK 1.7.12의 공식 @morit/cli를 재사용하므로 CLI와 MCP가 서로 다른 계약을 유지하지 않습니다.

설치

Node.js 20.12 이상이 필요합니다.

codex mcp add morit-plugin-local -- npx -y @morit/plugin-mcp
codex mcp list

claude mcp add --scope user morit-plugin-local -- npx -y @morit/plugin-mcp
claude mcp list

기본 workspace는 MCP process의 현재 작업 디렉터리입니다. 범위를 고정하려면 MORIT_PLUGIN_WORKSPACE에 절대 경로를 지정합니다. Cloud Tool을 사용하기 전에는 같은 OS 사용자로 한 번 로그인합니다.

npx -y @morit/cli login

권장 작업 순서

morit_sdk_contract
→ morit_docs_search / morit_docs_get
→ morit_project_create 또는 morit_project_open
→ morit_project_files_get / morit_project_files_put
→ morit_project_validate
→ UI가 있으면 morit_project_preview
→ morit_build_start / morit_build_status
→ morit_artifact_download

Local Tool은 프로젝트 생성·열기·revision 기반 편집, validate, preview, source ZIP, signed .mplg build를 제공합니다. CLI 로그인 뒤에는 morit_cloud_* Tool로 Project 연결·동기화, Secret, Connection, immutable Deployment를 관리할 수 있습니다.

사람이나 CI가 MCP 없이 작업할 때는 이 package에 CLI 인자를 전달하지 말고 공식 CLI를 사용합니다.

npx -y @morit/cli plugin validate .
npx -y @morit/cli plugin preview . --output ./dist/preview.html
npx -y @morit/cli plugin build .
npx -y @morit/cli plugin deploy . --visibility private

문서와 보안

배포 package의 assets/docs/는 저장소 docs/plugin_docs와 빌드 때 동기화됩니다. 먼저 assets/docs/README.md를 읽고, 에이전트 설치는 assets/docs/sdk-and-mcp.md, 전체 Tool 흐름은 같은 문서의 Local MCP 절을 참고하세요.

publisher private key와 OS credential은 Project source, source ZIP, MCP 응답에 포함되지 않습니다. .mplg에는 검증용 public key와 Ed25519 signature만 들어갑니다. Secret 값은 Cloud vault에만 저장하며 MCP의 list/get 응답은 identifier와 masked metadata만 반환합니다.

이미지 asset과 children/*.mplg는 Cloud JSON 경계에서만 검증된 binary envelope로 전송되고, 로컬 파일·source ZIP·최종 package에서는 원본 바이트가 유지됩니다.