Windows용 Claude MCP 데이터 탐색기

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

필수 조건

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

Related MCP server: Linear MCP Server

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

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

수동 테스트

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

npm run build npm run start

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

작동 원리

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

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

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

용법

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

문제 해결

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