한국인 페르소나 MCP 서버 설치·사용법 — NVIDIA Nemotron-Personas

Q: Claude Desktop 설정 파일은 어디에 있나요?

macOS는 ~/Library/Application Support/Claude/claude_desktop_config.json, Windows는 %APPDATA%\Claude\claude_desktop_config.json에 있습니다.

Q: Cursor에서도 사용할 수 있나요?

네. Cursor는 .cursor/mcp.json 파일에 동일한 형식으로 mcpServers 블록을 추가하면 됩니다. command와 args 값은 Claude Desktop과 동일하게 입력합니다.

TL;DR: Korean People Persona MCP 서버를 설치하면 Claude나 Cursor 안에서 NVIDIA Nemotron-Personas-Korea 데이터셋의 100만 건 한국인 합성 페르소나를 자연어로 검색할 수 있습니다. API 키 없이 로컬 SQLite 데이터베이스로 동작하며, 설치는 저장소 클론 → 데이터 변환 → 설정 파일 수정의 세 단계로 완료됩니다. UX 리서치·마케팅 분석·서비스 시뮬레이션에 즉시 활용할 수 있는 실용적인 도구입니다.

왜 한국인 페르소나 데이터가 필요한가

서비스를 기획하거나 UX를 설계할 때 “실제 사용자 관점”을 빠르게 확인하고 싶은 순간이 많습니다. 직접 사용자 인터뷰를 수백 건 진행하기는 어렵고, 해외 합성 데이터는 한국 사용자의 소득·거주지·직업·가족 구성 같은 맥락을 반영하지 못합니다.

NVIDIA가 Hugging Face에 공개한 Nemotron-Personas-Korea 데이터셋은 이 간극을 메웁니다. 약 100만 명의 가상 한국인 인물 정보를 AI가 생성한 합성 데이터로, 실제 개인정보는 포함되지 않습니다. 나이·직업·거주 지역·관심사·소득 수준 등 다양한 속성이 포함되어 있어, 타깃 페르소나를 빠르게 샘플링하거나 서비스 시나리오를 검증하는 데 유용합니다.

Korean People Persona MCP 서버는 이 대용량 데이터셋을 SQLite + FTS5(전문 검색) 형태로 변환해 MCP 프로토콜로 제공합니다. AI 에이전트가 자연어로 “30대 초반, 서울 거주, IT 직종 여성 페르소나 5명 보여줘”라고 요청하면 즉시 결과를 돌려줍니다.

서버 구조 한눈에 보기

Claude Desktop / Cursor
        │  MCP (stdio)
        ▼
Korean People Persona MCP Server (Python)
        │  SQL / FTS5 쿼리
        ▼
로컬 SQLite DB (Nemotron-Personas-Korea 변환 데이터)
        │  최초 1회만 다운로드
        ▼
Hugging Face — NVIDIA Nemotron-Personas-Korea 데이터셋

데이터는 최초 1회만 다운로드하고, 이후 모든 조회는 로컬에서 처리됩니다. 외부 API 키가 불필요하며 인터넷 없이도 빠른 검색이 가능합니다.

준비물

항목	버전·조건
Python	3.10 이상
uv (패키지 매니저)	최신 버전 권장
git	저장소 클론용
디스크 공간	데이터셋 크기에 따라 수 GB 필요(상세는 저장소 README 확인)
Claude Desktop 또는 Cursor	MCP 클라이언트로 사용

uv가 설치되어 있지 않다면 아래 명령으로 먼저 설치합니다.

curl -LsSf https://astral.sh/uv/install.sh | sh

단계별 설치 방법

1단계 — 저장소 클론

git clone https://github.com/civilian7/korean-people-persona
cd korean-people-persona

2단계 — 의존성 설치

uv sync

uv sync는 pyproject.toml에 정의된 모든 의존성을 자동으로 설치합니다. 가상 환경도 자동으로 생성됩니다.

3단계 — 데이터셋 다운로드 및 SQLite 변환

저장소에 포함된 데이터 준비 스크립트를 실행합니다. 상세 명령은 저장소의 README.md를 참고하세요. Hugging Face 계정이 필요한 경우 아래 명령으로 먼저 로그인합니다.

uv run huggingface-cli login

로그인 후 README에 안내된 데이터 변환 스크립트를 실행합니다. 100만 건 데이터를 처음 변환할 때는 시간이 다소 걸릴 수 있습니다. 변환이 완료되면 프로젝트 디렉터리 내에 SQLite DB 파일이 생성됩니다.

4단계 — Claude Desktop 설정 파일 수정

Claude Desktop 설정 파일(claude_desktop_config.json)을 열고 mcpServers 항목에 아래 블록을 추가합니다.

macOS 경로: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows 경로: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "korean-people-persona": {
      "command": "uv",
      "args": [
        "--directory",
        "/절대경로/korean-people-persona",
        "run",
        "server.py"
      ]
    }
  }
}

/절대경로/korean-people-persona 부분을 실제로 저장소를 클론한 디렉터리의 절대 경로로 바꿉니다. macOS 예시라면 /Users/사용자이름/korean-people-persona 형태입니다.

기존에 다른 MCP 서버가 설정되어 있다면 mcpServers 객체 안에 새 항목으로 추가하면 됩니다.

5단계 — Claude Desktop 재시작 및 확인

설정 파일을 저장한 뒤 Claude Desktop을 완전히 종료했다가 다시 실행합니다. 채팅 창 하단의 MCP 도구 아이콘을 클릭해 korean-people-persona 서버가 연결됐는지 확인하세요.

정상 연결되었다면 다음과 같은 프롬프트로 테스트할 수 있습니다.

40대, 경기도 거주, 자영업 남성 페르소나 3명을 찾아줘.

Cursor에서 사용하는 방법

Cursor를 MCP 클라이언트로 사용한다면 프로젝트 루트의 .cursor/mcp.json 파일에 동일한 형식으로 설정을 추가합니다.

{
  "mcpServers": {
    "korean-people-persona": {
      "command": "uv",
      "args": [
        "--directory",
        "/절대경로/korean-people-persona",
        "run",
        "server.py"
      ]
    }
  }
}

Cursor를 재시작하면 Composer·Agent 모드에서 페르소나 검색 도구를 호출할 수 있습니다.

흔한 오류와 해결법

오류 증상	원인	해결 방법
MCP 서버가 목록에 나타나지 않음	설정 파일 JSON 문법 오류	JSON 검증 도구로 `claude_desktop_config.json` 확인 후 재시작
`uv: command not found`	uv 미설치	`curl -LsSf https://astral.sh/uv/install.sh
데이터셋 다운로드 403 오류	Hugging Face 인증 필요	`uv run huggingface-cli login`으로 로그인 후 재시도
SQLite DB 파일 없음 오류	데이터 변환 미완료	저장소 README의 데이터 준비 단계를 다시 실행
절대 경로 오류	경로에 공백 또는 한글 포함	경로를 영문·숫자만으로 구성하거나 따옴표로 올바르게 감싸기

JSON 설정 파일에서 가장 흔한 실수는 마지막 항목 뒤에 쉼표(,)를 남기는 것입니다. JSON은 후행 쉼표를 허용하지 않으므로 반드시 제거해야 합니다.

활용 시나리오

이 MCP 서버를 연결하면 Claude가 직접 데이터베이스를 조회해 결과를 가져오므로, 별도의 코드 작성 없이 다양한 업무에 활용할 수 있습니다.

UX·서비스 기획

“20대 후반, 1인 가구, 배달 앱 헤비유저 페르소나 5명”을 뽑아 사용자 스토리 초안 작성
특정 지역·연령대의 페르소나 분포 파악

마케팅·콘텐츠

캠페인 타깃 페르소나 샘플링
타깃 고객의 관심사·소비 패턴 시뮬레이션

AI 에이전트 테스트

챗봇이나 추천 시스템을 다양한 가상 사용자로 시험해 엣지 케이스 발견
대화형 서비스의 다양성 검증

자주 묻는 질문

API 키가 없어도 사용할 수 있나요?

네. Korean People Persona MCP 서버는 외부 API 키가 필요 없습니다. Hugging Face에서 데이터셋을 다운로드해 로컬 SQLite DB로 변환한 뒤 완전히 오프라인으로 조회할 수 있습니다.

Hugging Face 데이터셋 다운로드에 계정이 필요한가요?

NVIDIA Nemotron-Personas-Korea 데이터셋의 접근 권한 설정에 따라 Hugging Face 계정 로그인이 필요할 수 있습니다. 저장소 GitHub README에서 최신 접근 정책을 확인하세요.

100만 건 데이터를 전부 로컬에 저장해야 하나요?

네. 이 서버는 로컬 SQLite + FTS5 방식으로 동작합니다. 전체 데이터셋을 한 번 다운로드해 변환하면 이후에는 인터넷 연결 없이 빠르게 전문 검색이 가능합니다.

Claude Desktop 설정 파일은 어디에 있나요?

macOS는 ~/Library/Application Support/Claude/claude_desktop_config.json, Windows는 %APPDATA%\Claude\claude_desktop_config.json에 있습니다.

Cursor에서도 사용할 수 있나요?

네. Cursor는 .cursor/mcp.json 파일에 동일한 형식으로 mcpServers 블록을 추가하면 됩니다. command와 args 값은 Claude Desktop과 동일하게 입력합니다.

데이터셋의 합성 페르소나란 무엇인가요?

NVIDIA Nemotron-Personas-Korea는 실제 개인 정보가 아닌, LLM이 생성한 가상의 한국인 인물 정보 약 100만 건으로 구성된 합성 데이터셋입니다. 개인정보 침해 없이 다양한 사용자 시뮬레이션·UX 연구·마케팅 분석에 활용할 수 있습니다.

다음 단계

Korean People Persona MCP 서버 설치가 완료됐다면, 가이드 목록에서 다른 한국 데이터 MCP 서버 튜토리얼도 살펴보세요. 한국 부동산 실거래가 조회, 공공데이터포털 API 연동 등 실무에 바로 활용할 수 있는 서버들이 준비되어 있습니다. 직접 개발한 MCP 서버가 있다면 서버 등록 페이지를 통해 MCP모아에 제출해 더 많은 개발자와 공유할 수 있습니다.