# Flow Learning System MCP server

> Build motion-graphics textbooks with sentence-synced TTS, 3D Blender renders, and verified code examples using AI-driven tools.

- Repository: https://github.com/ghlee0786/flow-learning-system
- Page: https://hostedmcp.org/servers/ghlee0786/flow-learning-system
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 0.1.0

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `FLS_BLENDER` | no | no |  |

## Tools (13)

- `authoring_guide`: 레슨 JSON 형식(op, 장면 옵션, 위젯), 모션 규칙, TTS 문장 쓰는 법을 담은 가이드. 레슨을 쓰기 전에 읽으세요.
- `course_init`: 새 코스 폴더를 만듭니다. code_lang: csharp | python, voice: F1~F5, M1~M5.
- `course_status`: 코스의 레슨 목록, 장면 수, 형식 문제 수, 음성 상태를 보여 줍니다.
- `lesson_get`: 레슨 JSON 하나를 그대로 돌려줍니다(고쳐 쓸 때).
- `lesson_save`: 레슨 JSON을 검사하고, 오류가 없으면 lessons/NN.json으로 저장합니다(같은 id면 덮어씀). lesson = {"id": 1, "group": "...", "title": "...", "sub": "...", "ops": [...]}
- `lesson_validate`: 레슨 형식을 검사합니다(없는 코드 줄, 모르는 op·위젯, 읽기 어려운 단어 등). lesson_id를 비우면 전체.
- `speech_preview`: 장면마다 TTS가 실제로 읽을 문장을 보여 주고, 영어 단어처럼 읽기 어려운 조각을 표시합니다.
- `pronunciation_add`: 영어 단어의 한글 읽기를 코스에 등록합니다. 예: word="Dictionary", reading="딕셔너리".
- `code_verify`: 코드 블록을 실제로 컴파일·실행해 화면 콘솔 출력(out/write)과 같은지 확인합니다. C#은 mono 또는 dotnet, Python은 python.
- `audio_synthesize`: Supertonic TTS로 레슨 음성(audio/lNN.mp3)과 문장별 시각표(timing.json)를 만듭니다. 바뀌지 않은 레슨은 건너뜁니다. 레슨이 많으면 lesson_id를 하나씩 주어 나눠 실행하세요.
- `render_3d`: Blender로 3D 장면을 렌더해 assets/<name>.png 와 핫스폿 좌표를 만듭니다. script: bpy 파이썬 코드(장면만 만들면 됨). spot("이름", (x, y, z))로 찍은 3D 위치가 이미지의 어디인지 계산되어, 레슨에서 {"img": ["assets/<name>.png", {"spots": ["이름"], "arrows": [{"from": "a", "to": "b"}]}]}로 가리킬 수 있습니다. 도우미: mat(이름, (r,g,b), rough, metal, emit, sss), paint(obj, mat), spot, camera(위치, 대상, lens), sun, area, world, look_at, cylinder_between. Blender가 PATH에 없으면 FLS_BLENDER 환경 변수에 실행 파일 경로를 넣으세요.
- `assets_list`: 코스의 이미지와 각 이미지의 핫스폿 이름·좌표(0~1)를 보여 줍니다.
- `course_build`: 한 파일짜리 HTML 플레이어(dist/index.html)와 음성 파일을 만듭니다. 음성이 없는 레슨은 소리 없이 예상 시간으로 진행합니다.

## FAQ

### What subjects can the system handle?

It works for any subject including math, science, English, biology, and programming.

### How does the system handle 3D illustrations?

The render_3d tool runs AI-written Blender scripts headlessly to render images and compute hotspot coordinates for labels and arrows.

### What happens if I don't have Supertonic installed?

The textbook will still run, but it will use estimated timings instead of synthesized audio.
