SeeAny Sun MCP

이 디렉터리는 Codex, Claude Desktop, Cursor 등 MCP Client에서 호출할 수 있는 로컬 stdio MCP Server를 제공합니다.

두 가지 모드를 지원합니다:

• demo: 키가 필요 없으며, 저장소 내의 상품 이미지를 사용해 오프라인 시뮬레이션을 수행하고 유료 API를 호출하지 않습니다.

• live: SEEANY_API_KEY를 설정하면 메인 사이트 https://api.seeany.com을 호출하며, 이미지 업로드, 스마트 생성, 작업 폴링, 다운로드 및 AI 다듬기를 지원합니다.

인증 환경 변수

공통으로 사용:

SEEANY_API_KEY=sk-sa-xxxxxxxx

실제 Key를 Git, 브라우저 코드 또는 채팅 메시지에 작성하지 마세요. .env.example을 로컬 환경으로 복사한 후 작성하면 됩니다. Key가 없으면 서비스는 자동으로 Demo 모드로 전환됩니다. SEEANY_MCP_MODE=demo를 사용하여 오프라인 모드를 강제할 수도 있습니다.

Related MCP server: metalevel/snapix-mcp-server

로컬 설치 및 테스트

cd mcp-server
npm install
npm run build
npm run smoke

Smoke test는 Demo 모드를 강제로 사용하므로 실제 비용이 발생하지 않습니다.

실제 전체 흐름 검증(메인 사이트 계정 비용 발생)이 필요하면 새 Key가 설정되었는지 확인한 후 다음을 실행하세요:

npm run live-smoke

Codex 연결

codex mcp add seeany-sun-mcp -- npx --yes seeany-sun-mcp

Codex 플러그인으로 설치(MCP + Skill)

저장소는 Codex 플러그인 매니페스트도 제공합니다. 설치하면 SeeAny MCP 도구와 seeany-product-visuals 상품 비주얼 워크플로 Skill을 함께 얻을 수 있습니다.

codex plugin marketplace add juin20260102-oss/seeany-sun-mcp --sparse .agents/plugins
codex plugin add seeany-sun-mcp@seeany

설치 후 새 Codex 대화를 시작하세요. 실제 이미지 생성 시에는 여전히 로컬 환경에서 SEEANY_API_KEY를 설정해야 합니다. MCP 도구만 필요하다면 위의 codex mcp add를 사용하면 됩니다.

실제 API를 사용하는 경우 MCP를 시작한 동일한 환경에서 SEEANY_API_KEY를 설정하세요. 연결 후 먼저 seeany_get_capabilities를 호출한 다음 다음 순서대로 호출하는 것이 좋습니다:

1. seeany_upload_asset(참조 이미지가 있는 경우)

2. seeany_refine_prompt(선택 사항)

3. seeany_generate_product_image

4. seeany_wait_generation

5. seeany_download_assets

MCP Inspector

npm run inspect

현재 실제 API 매핑

작업은 기본적으로 비동기 모드를 사용합니다. 메인 사이트 API의 이미지/비디오 작업은 계정 설정에 따라 과금되며, seeany_quote_generation은 예상 값만 반환하고 비용을 선차감하지 않습니다.

SeeAny Skill

저장소에는 skills/seeany-product-visuals가 포함되어 있으며, 에이전트가 "참조 이미지 업로드 → 프롬프트 다듬기 → 견적 요청 → 생성 → 폴링 → 다운로드"의 전체 흐름에 따라 MCP를 호출하도록 안내합니다. npm 패키지에도 이 Skill 디렉터리가 포함됩니다.

npm 패키지 이름

현재 패키지 이름은 seeany-sun-mcp로 정했으며, 먼저 공개된 스코프 없는 패키지로 게시하기에 적합합니다. 정식 게시 전에 npm에서 이름을 사용할 수 있는지 확인해야 합니다. SeeAny가 npm 스코프를 이미 구축한 경우 @seeany/sun-mcp로 마이그레이션할 수도 있습니다.

게시 후 가장 간단한 호출 방법:

npx --yes seeany-sun-mcp

게시 전 패키지 내용 확인:

npm run pack:check

자동 테스트 및 게시

GitHub Actions는 main 브랜치 Push 및 Pull Request 시 Node.js 20, 22, 24를 사용하여 플러그인 검증, MCP Smoke Test 및 npm 패키징 검사를 수행합니다.

새 버전을 게시할 때 먼저 package.json, package-lock.json 및 .codex-plugin/plugin.json의 버전을 동기화하여 업데이트한 다음 동일한 버전의 Git Tag를 생성하세요:

git tag v0.5.0
git push origin v0.5.0

release.yml은 Tag와 패키지 버전이 일치하는지 검증한 다음 npm Trusted Publishing을 통해 게시하고 GitHub Release를 생성합니다. 처음 사용하기 전에 npm 패키지 설정에 GitHub Actions Trusted Publisher를 추가해야 합니다:

• GitHub 사용자: juin20260102-oss

• 저장소: seeany-sun-mcp

• Workflow: release.yml

• 허용 작업: npm publish