ChatGPT ──MCP──▶ persona-mcp ──┬─ PostgreSQL (조건/통계/클러스터)
                               └─ Qdrant (의미 검색)

# 1) 전체 기동 (postgres, qdrant, mcp, dashboard)
docker compose up -d

# 2) 데이터 적재 (최초 1회, 100만 건)
docker compose run --rm etl

# 3) 임베딩 POC (10,000건 → Qdrant)
docker compose run --rm embed

http://192.168.31.253:19000/mcp

{
  "mcpServers": {
    "persona": {
      "command": "docker",
      "args": ["exec", "-i", "persona-mcp", "python", "server.py"]
    }
  }
}

# 전체 통계
curl http://192.168.31.253:18080/api/stats

# 구조화 검색 (경기 40대 여성)
curl 'http://192.168.31.253:18080/api/search?province=경기&age_min=40&age_max=49&sex=여자&limit=5'

# 의미 검색
curl 'http://192.168.31.253:18080/api/similar?q=자녀%20교육'

# MCP 툴 목록
curl http://192.168.31.253:18080/api/mcp/tools

# MCP 툴 실행 (집단 통계)
curl -X POST http://192.168.31.253:18080/api/mcp/call \
  -H 'Content-Type: application/json' \
  -d '{"toolName":"aggregate_persona","args":{"province":"경기","sex":"여자"}}'

# initialize (세션 획득)
curl -X POST http://192.168.31.253:19000/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

import asyncio, json
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async def main():
    async with streamablehttp_client('http://192.168.31.253:19000/mcp') as (r, w, _):
        async with ClientSession(r, w) as s:
            await s.initialize()
            res = await s.call_tool('similar_persona', arguments={
                'query': '자녀 교육에 관심이 많은 40대 여성',
                'province': '경기',
                'limit': 5,
            })
            print(json.loads(res.content[0].text))

asyncio.run(main())

docker compose down        # 컨테이너만
docker compose down -v     # 볼륨(데이터)까지 삭제

@software{nvidia/Nemotron-Personas-Korea,
  author = {Kim, Hyunwoo and Ryu, Jihyeon and Lee, Jinho and Ryu, Hyungon and Praveen, Kiran and Prayaga, Shyamala and Thadaka, Kirit and Jennings, Will and Sadeghi, Bardiya and Sharabiani, Ashton and Choi, Yejin and Meyer, Yev},
  title = {Nemotron-Personas-Korea: Synthetic Personas Aligned to Real-World Distributions for Korea},
  month = {April},
  year = {2026},
  url = {https://huggingface.co/datasets/nvidia/Nemotron-Personas-Korea}
}