API 문서

sussy seeds MCP

ONI 시드 사냥을 위한 로컬 MCP 서버입니다. 제약 스펙을 조합하고, 수백만 시드를 스캔하고, 일치 항목을 살펴보고, 결과를 공유하세요.

Claude Code에 추가
claude mcp add sussy-seeds -- npx -y @onimaxxing/sussy-seeds-mcp

또는 .mcp.json (프로젝트) / ~/.claude/settings.json (사용자) 파일에서:

{
  "mcpServers": {
    "sussy-seeds": {
      "command": "npx",
      "args": ["-y", "@onimaxxing/sussy-seeds-mcp"]
    }
  }
}
Claude Desktop에 추가

~/Library/Application Support/Claude/claude_desktop_config.json 파일에 추가하세요 (macOS 기준, 다른 플랫폼은 이에 상응하는 경로):

{
  "mcpServers": {
    "sussy-seeds": {
      "command": "npx",
      "args": ["-y", "@onimaxxing/sussy-seeds-mcp"]
    }
  }
}
Codex CLI에 추가
codex mcp add sussy-seeds -- npx -y @onimaxxing/sussy-seeds-mcp

또는 ~/.codex/config.toml 파일을 직접 편집:

[mcp_servers.sussy-seeds]
command = "npx"
args = ["-y", "@onimaxxing/sussy-seeds-mcp"]
Cherry Studio에 추가

Cherry Studio에서 설정 → MCP 서버 → 서버 추가를 열고, 유형을 stdio로 선택한 뒤 다음을 입력하세요:

Command:   npx
Arguments: -y @onimaxxing/sussy-seeds-mcp
Trae에 추가

Trae에서는 ~/.trae/mcp.json (전역) 또는 프로젝트의 .trae/mcp.json 파일에 서버를 추가:

{
  "mcpServers": {
    "sussy-seeds": {
      "command": "npx",
      "args": ["-y", "@onimaxxing/sussy-seeds-mcp"]
    }
  }
}
Qwen Code에 추가

다음 mcpServers 항목을 ~/.qwen/settings.json 파일에 추가:

{
  "mcpServers": {
    "sussy-seeds": {
      "command": "npx",
      "args": ["-y", "@onimaxxing/sussy-seeds-mcp"]
    }
  }
}
기타 클라이언트

같은 {command, args} 형태가 Cursor, Windsurf, Zed, Continue, Cline에서 동일하게 작동합니다. Claude.ai (웹)는 지원되지 않습니다. 웹 커넥터는 호스팅된 URL을 요구하는데 이 서버는 stdio로 로컬에서 실행되기 때문입니다.

요구 사항

Node 20 이상.

도구
탐색
  • listClusters클러스터 id와 중복 구분
  • listWorlds / listWorldsAcrossClusters좌표의 세계 또는 클러스터 전반의 세계
  • listGeysers / listTraits / listBiomes / listPoisid 카탈로그
  • listStoryTraits / listMixingCategories스토리 특성, DLC 혼합
  • listSpawnTags스폰 가능한 크리터 / 식물 태그
  • listConstraintKinds빌더 AST 제약 형태
  • listHelpers스펙 헬퍼 함수
  • listPrefabAdmissibility프리팹이 스폰될 수 있는 위치
모드 콘텐츠
  • listModExtensions스캔 가능한 성단을 가진 창작마당 모드(coordinatePrefix + 세계 목록)와 setTraitOverlays용 특성 모드 목록.
  • setTraitOverlays성단 없는 특성 모드를 세션에 활성화합니다 — 게임에 모드를 설치한 것처럼 모든 스캔 스냅숏에 병합됩니다.
  • registerCluster인라인 세계생성 YAML로 세션용 사용자 지정 성단을 등록합니다.
  • useCgmPresetCluster Generation Manager 프리셋을 스캔 가능한 CGM 성단으로 등록합니다. baseCoord에 시드·스토리 특성·혼합 설정이 담깁니다.
좌표 조합
  • buildCoord폼 상태로부터 좌표 문자열 생성
  • parseCoord / describeCoord좌표 문자열 해석
  • freshCoord클러스터의 무작위 좌표
허용성
  • verdictOf / verdictOfSpec제약 또는 전체 스펙을 좌표에 대해 검사
스캔
  • scan시드 범위에서 상위 K개
  • scanUntil일치 N개에서 중단
  • scanSeeds입력 시드당 한 행
검사
  • getSeedSummary / getSeedDeep시드 하나의 세계생성 출력
  • describeSeed시드의 평이한 영어 설명
공유
  • shareResults웹 스캐너에 스펙을 불러오고 시드를 고정하는 공유 URL
진단
  • ping / probeStreaming상태 및 진행 스트림 확인
스캐너 UI

/sussy-seeds/ 페이지는 같은 스캐너를 브라우저에서 실행합니다. 공유 URL은 MCP와 웹 앱 사이를 오갑니다. 스펙 문법은 다음 문서에 있습니다: API 문서.