variet-agent/docs/devlog/entries/20260312-001.md

MCP 기반 에이전트 아키텍처 재설계

• 시간: 2026-03-12 15:00~16:45
• Commit: 246d2a2
• Vikunja: 신규 태스크

결정 사항

• Gemini CLI의 네이티브 MCP 지원을 활용하여 에이전트 루프를 직접 구현하지 않고 CLI에 위임
• unified.md 단발성 JSON 분류 → Gemini CLI 내부 추론 루프(ReAct 패턴)로 전환
• anime 하드코딩 핸들러 → MCP 도구로 표준화 (향후 모든 새 기능도 MCP 서버로 추가)
• MCP settings는 홈 레벨 ~/.gemini/settings.json에 등록 (프로젝트 레벨은 cwd 문제)

변경 파일

• mcp_servers/anime_server.py — 5개 MCP 도구 (검색/다운/편성표/상태/NAS)
• mcp_servers/infra_server.py — 7개 MCP 도구 (Gitea + Vikunja)
• .gemini/settings.json — 프로젝트 레벨 MCP 설정 (백업용)
• prompts/agent.md — 범용 에이전트 프롬프트
• core/gemini_caller.py — MCP 설정 자동 등록 + 역할별 지시 분기
• api/discord_bot.py — _unified_call→_agent_call, 4-mode 분기 제거, 진행 표시 추가

미완료

• _handle_anime, _handle_task dead code 아직 남아있음 (실 테스트 후 제거)
• Discord 실행 + 실제 메시지 테스트 미수행
• Plan→Code→Review 품질 루프 대체 방안 검토 필요