🍯 HoneyMCP — 얼불춤(ADOFAI) 고퀄리티 맵 자동생성 MCP

"맵 만들어줘" 한마디면 유튜브급 커스텀 맵이 나옵니다. A Model Context Protocol server that generates human-quality A Dance of Fire and Ice custom levels from any song. 노래를 주면 실제 음표에 맞춘 타일길 + 매직서클 + 카메라/조명 이펙트까지 자동으로 뽑아줍니다.

✨ 핵심 기술 (왜 노잼이 아닌가)

Related MCP server: FL Studio MCP Server

📋 요구사항

• Python 3.10+

• ffmpeg (음표 추출용. 없으면 기계 그리드 폴백으로 동작)

  • Windows: winget install ffmpeg (또는 ffmpeg.org)

• 얼불춤 본편 (결과물 확인용. 생성 자체는 게임 없이 됨)

🚀 설치

git clone https://github.com/dohunkr/HoneyMCP.git
cd HoneyMCP
pip install -e ".[dev]"

🔌 MCP 연결법 (클라이언트별)

서버 실행 명령(공통): python -m honey_mcp.server (stdio 방식)

⚠️ 설정 후 클라이언트를 완전히 종료→재시작해야 반영됩니다.

opencode (opencode.json — 프로젝트 루트)

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "honey-adofai": {
      "type": "local",
      "command": ["C:/Python310/python.exe", "-m", "honey_mcp.server"],
      "enabled": true
    }
  }
}

command의 python 경로는 본인 환경에 맞게 수정. .venv 사용 시 .venv/Scripts/python.exe 절대경로 권장. opencode.json.example 참고. 연결 확인: 툴 목록에 honey-adofai가 보이면 OK.

Claude Code (.mcp.json — 프로젝트 루트)

{
  "mcpServers": {
    "honey-adofai": {
      "command": "python",
      "args": ["-m", "honey_mcp.server"],
      "cwd": "D:/Github/ADOFAI/HoneyMCP"
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "honey-adofai": {
      "command": "python",
      "args": ["-m", "honey_mcp.server"],
      "cwd": "D:/Github/ADOFAI/HoneyMCP"
    }
  }
}

Antigravity / Codex

MCP 설정에 stdio 서버로 등록 (위와 동일): command python, args ["-m", "honey_mcp.server"], cwd = 이 폴더.

🎮 사용법

채팅에 노래 파일 경로만 주면 됩니다:

D:\Music\track.ogg 로 맵 만들어줘 (★5, 화려하게)

AI는 자동으로 analyze_song → generate_full_map → 품질게이트를 수행합니다. 출력: D:/Github/ADOFAI/HoneyMap_<곡명>/ 안에 .adofai + 노래 복사본 → 얼불춤 레벨 에디터로 폴더를 열어서 F5 테스트플레이.

MCP 없이 직접 생성도 가능:

python tools/make_map.py --audio "C:/Music/song.ogg" --outdir "D:/Github/ADOFAI/HoneyMap_song" `
    --title "Song" --artist "Artist" --difficulty 5 --style showcase --seed 7

• difficulty: 1~10 (★5-6 권장. ★5부터 2키 동시치기, ★7부터 6개, ★9부터 3키)

• style: showcase(화려) / clean(깔끔) / party

🧰 MCP 도구

🛡️ 품질 게이트 (재발방지)

errors (하나라도 있으면 자동 재생성):

• 게임 enum 위반 (Forward 등 — 과거 로딩 크래시 원인)

• SetSpeed가 기준의 0.35~3배 초과 (불가능 구간)

• floor 범위 초과 / 타일 부족 / BPM 범위 이탈

warnings (점수 감점):

• 직선 7연속 고속도로 / 좌우회전 편중 / 타일 겹침 / 음표 싱크율 60% 미만

🗺️ 맵 출력 규칙

• 모든 맵은 D:/Github/ADOFAI/HoneyMap_<곡명>/ 에 생성 (프로젝트 폴더와 분리)

• 예시: 도라에몽 피아노 커버 → 타일 210개, score 100, 싱크율 90%, 2키×3

🧪 개발

pytest -q

구조: src/honey_mcp/ — server.py(MCP) / audio.py / onsets.py(음표추출) / chart.py(채보+배치) / effects.py(이펙트) / adofai.py(파일IO+검증+멀티프레스)

❓ 트러블슈팅

📄 라이선스

MIT — 자유롭게 쓰고 고치고 공유하세요. 맵을 만들 때 사용한 노래의 저작권은 각 권리자에게 있습니다.