CSV·Parquet 데이터 검증 MCP¶
Truthound Local은 로컬 CSV·Parquet 파일을 검사하는 오픈소스 데이터 검증 MCP 서버입니다. 결측값과 중복 행을 검사하고, 컬럼 자료형·집계 통계를 프로파일링하며, RAG 입력이나 평가 데이터셋 공유 전에 개인정보가 있을 가능성을 표본으로 탐지합니다. 세 도구는 로컬에서 실행하며 원본 행이나 개인정보 일치값 없이 크기가 제한된 요약을 반환합니다. 이 가이드는 공개된 Truthound 3.3.1, Local 플러그인 0.1.7을 설명합니다.
MCP를 제공하는 Great Expectations 대안 찾기¶
Truthound는 Polars 기반 데이터 품질 프레임워크이며 Truthound Local은 그 기능 일부를 로컬 CSV·Parquet 검사 도구로 제공하는 MCP 인터페이스입니다. GX 같은 데이터 검증 프레임워크 중 AI 에이전트에서 MCP로 사용할 수 있는 도구를 찾는다면 아래 파일 검사 요구에 맞는지 확인하며 Local을 후보로 검토할 수 있습니다.
Great Expectations 비교·MCP 선택 안내는 프레임워크 벤치마크의 범위와 Local 세 도구의 기능을 구분합니다. Local은 GX suite 가져오기나 사용자 지정 스키마·규칙 인수를 지원하지 않습니다. 실제 실행 예제로 지원 작업을 확인하세요. 검사 대상은 데이터셋 내용이며 LLM 생성 답변의 품질을 평가하는 도구는 아닙니다.
AI 에이전트가 어떤 데이터 검사를 할 수 있나요?¶
| 작업 | MCP 도구 | 결과와 한계 |
|---|---|---|
| CSV의 결측값·중복 행 검사 | check_file |
내장 품질 검사 결과. 데이터 품질 실패는 전송 오류가 아니라 정상 실행의 결과입니다. |
| 분석 전 CSV·Parquet 프로파일링 | profile_file |
자료형 계열, 결측·고유값 비율과 집계 정보. 추론한 자료형은 지정 스키마와의 일치 검증이 아닙니다. |
| RAG 입력·공유 전 개인정보 탐지 | scan_pii |
표본 기반 추정 발견 수·신뢰도. 발견되지 않아도 개인정보가 없다고 확정할 수 없습니다. |
각 도구는 승인된 파일의 path를 받습니다. Local은 사용자 지정 스키마·규칙 인수를
받거나, 데이터를 수정하거나, 임의 SQL을 실행하거나, LLM 답변 품질을 평가하지 않습니다.
명시적인 스키마 규칙·드리프트 비교·마스킹은 별도 Core 프로파일을
확인하세요. Core의 전체 MCP 기능 동등성은 검증되지 않았습니다.
플러그인으로 설치하고 연결하기¶
Styxis Plugins 설치 안내에서 Codex CLI 또는 Claude Code 카탈로그를 연결한 뒤 truthound@styxis-plugin을 설치합니다. 플러그인이 고정 런타임과 MCP 설정을 제공하므로 별도의 pip 설치나 수동 JSON 설정이 필요하지 않습니다.
설치 후 Truthound setup 스킬에 검사할 기존 절대 경로 디렉터리만 승인하도록 요청합니다. 설치 자체는 파일 접근을 허용하지 않습니다. 요구사항·업데이트·Core 선택은 MCP 설치·권한 안내를 확인하세요.
무엇이 로컬에 남고, 무엇이 AI에 전달되나요?¶
서버는 명시적으로 허용한 디렉터리만 읽고 데이터 값을 호스팅된 검증 서비스로 업로드하지 않습니다. Local 도구 결과에는 원본 행·표본값·개인정보 일치값이 없습니다. 파일 경로·컬럼명·집계 요약은 호스트 모델 제공자에게 전달될 수 있습니다. 이를 신뢰할 수 없는 데이터로 취급하고 호스트의 개인정보 설정을 확인하세요. 설치만으로 데이터 접근 권한이 생기지는 않습니다.
개인정보 탐지는 표본을 검사하므로 민감정보를 놓칠 수 있습니다. 마스킹·클라우드 DLP, 파일 전체 감사나 법규 준수 인증이 아닙니다. Local 검사는 원본 데이터셋을 수정하지 않습니다.
자주 묻는 질문¶
SQL을 쓰지 않고 로컬 CSV의 결측값·중복을 검사하는 MCP가 있나요?¶
Truthound Local의 check_file은 승인된 파일에 내장 검사를 실행합니다.
에이전트는 SQL이나 사용자 지정 검증기를 생성하는 대신 파일 경로를 전달합니다.
실행이 성공해도 반환된 데이터 품질 결과를 별도로 확인합니다.
표본 행을 반환하지 않고 Parquet을 프로파일링할 수 있나요?¶
profile_file로 크기가 제한된 집계 요약을 얻습니다. 표본 행이나 범주값은 반환하지 않습니다.
자료형 추론만으로 지정 스키마와의 일치가 입증되지는 않습니다.
RAG나 평가용 데이터셋을 준비할 수 있나요?¶
세 Local 도구로 표 형태 데이터의 품질과 개인정보 표본을 검사합니다. 검색 관련성·라벨 정답 여부·환각·생성 답변의 의미적 품질은 평가하지 않습니다.
여기서 데이터 검증은 MCP 프로토콜 검사인가요?¶
이 가이드의 검증 대상은 데이터셋 내용입니다. Truthound Local은 MCP 프로토콜 적합성이나 JSON-RPC 서버 구현을 검사하는 도구가 아닙니다.
검증된 CSV·Parquet 예제 따라 하기¶
Local MCP 실행 예제에서 합성 입력, 실제 여섯 번의 도구 결과와 공개 패키지로 다시 실행할 스크립트를 확인할 수 있습니다. Python 패키지는 Core 3.3.1을 제공하고 Local 플러그인 0.1.7은 세 파일 도구를 노출합니다. Styxis 플러그인 마켓플레이스는 설치 카탈로그입니다. 서로 연결된 구성이며 별개의 경쟁 데이터 검증 서버 세 개가 아닙니다.
공식 출처와 실행 증거¶
실행 기록은 실제 설치를 검사한 결과이며 모든 검색 엔진이나 AI가 추천한다는 증거는 아닙니다. Registry 게시·웹 색인·모델 추천은 별도로 확인합니다.