Claude MCP Data Explorer

Windows용 Claude MCP 데이터 탐색기

Claude를 통한 데이터 탐색을 위한 모델 컨텍스트 프로토콜(MCP) 서버의 TypeScript 구현입니다. 이 서버는 Claude Desktop과 통합되어 CSV 파일을 로드하고 JavaScript 데이터 분석 스크립트를 실행하는 도구를 제공하여 고급 데이터 분석을 지원합니다.

필수 조건

• Node.js v16+ - Node.js 다운로드
• Claude Desktop - Claude Desktop 다운로드

설치(Windows용으로 업데이트됨)

1. 이 저장소를 복제하세요지엑스피1
2. 종속성 설치
   npm install
3. 설치 스크립트 빌드 및 실행
   npm run setup
   이렇게 하면:
   • TypeScript 코드를 JavaScript로 빌드합니다.
   • 컴파일된 JavaScript를 사용하도록 Claude Desktop을 구성합니다.
   • 필요한 디렉토리를 생성합니다
4. Claude Desktop을 다시 시작하고 개발자 모드를 활성화하세요.
   • Claude Desktop을 완전히 닫습니다.
   • Claude Desktop 시작
   • 도움말 → 개발자 모드 활성화로 이동

수동 테스트

다음을 실행하여 서버를 직접 테스트할 수 있습니다.

서버가 오류 없이 시작될 것입니다. 이 과정을 성공적으로 실행하면 Claude Desktop에서도 서버를 사용할 수 있을 것입니다.

작동 원리

이 MCP 서버는 Claude에게 두 가지 주요 도구를 제공합니다.

1. load-csv - 분석을 위해 CSV 데이터를 메모리에 로드합니다.
2. run-script - 데이터 처리 및 분석을 위한 JavaScript 코드를 실행합니다.

또한 클로드가 구조화된 데이터 탐색 과정을 안내하는 프롬프트 템플릿도 포함되어 있습니다.

용법

1. Claude Desktop 시작
2. "데이터 탐색" 프롬프트 템플릿을 선택하세요
   • 이 프롬프트는 설정 후 Claude Desktop에 나타납니다.
3. CSV 파일 경로와 탐색 주제를 입력하세요
   • 예시 파일 경로: C:/Users/YourName/Documents/data.csv
   • 예시 주제: "지역별 판매 추세"
4. Claude가 귀하의 데이터를 분석하게 하세요
   • Claude는 CSV 파일을 로드하고 자동으로 통찰력을 생성합니다.
   • 서버는 청킹을 사용하여 대용량 파일을 효율적으로 처리합니다.

문제 해결

1. Claude는 MCP 서버를 표시하지 않습니다.
   • %APPDATA%\Claude\claude_desktop_config.json 의 구성 파일을 확인하세요.
   • dist 디렉토리에 있는 컴파일된 JavaScript 파일을 가리켜야 합니다.
   • npm run build 로 프로젝트를 다시 빌드해보세요.
   • 개발자 모드를 활성화하고 MCP 로그 파일을 확인하세요(개발자 → MCP 로그 파일 열기)
   • 개발자 → 모든 MCP 서버 다시 로드를 사용하여 강제로 새로 고침
2. 파일 읽기 권한 오류
   • Claude가 CSV 파일 위치에 액세스할 수 있는지 확인하세요.
   • 절대 경로와 함께 슬래시( / ) 또는 이스케이프된 백슬래시( \\ )를 사용해 보세요.
3. 스크립트의 JavaScript 오류
   • 스크립트가 허용된 모듈과 호환되는지 확인하세요.
   • Claude의 응답에서 오류 메시지를 검토하세요.

특허

MIT 라이센스 - 자세한 내용은 라이센스 파일을 참조하세요.

감사의 말

• Anthropic의 공식 MCP TypeScript SDK 기반
• 예시와 영감을 제공해 주신 MCP 커뮤니티에 감사드립니다.