# 🎼 카카오보드 (KakaoBoard)

카카오톡(PlayMCP AI 채팅) 안에서 ★여러 AI를 친구처럼 불러 대화·토론·리서치·코딩하는 **멀티AI 오케스트라 MCP 서버**.
카카오 PlayMCP 공모전(Agentic Player 10, 마감 2026-07-14) 출품작.

## 핵심 = 상호작용 엔진 (우리 moat)
UI는 카톡창이라 우리가 못 만든다 → ★백엔드 '상호작용 엔진'이 전부. 블랙보드에서 검증된:
- **멤버 추가/관리** — 세션에 AI 멤버를 불러옴
- **멘션 라우팅** — @멤버 호출, #읽기만, @#발언권
- **★무한 핑퐁 금지 + 강제 중지** — 멤버끼리 무한 대화 방지(라운드 상한 + 동일발화 반복 감지 → 강제 종료)
- **UX 편의** — 키 없이 체험 → 발급도우미로 자기 무료키(BYOK) → 바로 멀티AI

## 구조 (Ghost 설계)
```
server.py                  # FastMCP 엔트리 (streamable-http), 도구 등록
services/
  orchestrator.py          # ★상호작용 엔진: 세션·멤버·멘션·핑퐁가드·강제중지 (블랙보드 이식)
  model_router.py          # 무료 API 우선 라우팅 (OpenRouter free 등 / BYOK)
  key_guide.py             # api_key_guide 발급 데이터
providers/                 # openrouter / groq / manus ...
```

## 도구 (MVP)
`add_member` · `list_members` · `orchestra_ask` · `orchestra_debate` · `research` · `code_task` · `api_key_guide` · `list_models`

## 상태
설계 완료(DESIGN.md §9). 골격 구현 중. 다음: PlayMCP 콘솔 hands-on(인증·transport·약관 확인) → 등록 → 예선 제출.

## 핵심 원칙
- ★API 키 = 유저 개별 BYOK(각자 발급). 공용키 발급·공유 절대 안 함(자폭 방지 + 고정비 외 과금 0).
- ★평문 키 인자/채팅 입력 금지(유출). PlayMCP 시크릿 주입 사용.
- ★원격 MCP라 유저 로컬파일 못 건드림(예선=클라우드 완결, 로컬IDE=v2).