MCP Excel Reader

MCP 엑셀 리더

자동 청킹 및 페이지 매김 기능을 지원하는 Excel 파일을 읽기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. SheetJS와 TypeScript로 구축된 이 도구는 대용량 Excel 파일을 관리하기 쉬운 청크로 자동 분할하여 효율적으로 처리할 수 있도록 도와줍니다.

특징

• 📊 자동 크기 제한으로 Excel 파일(.xlsx, .xls) 읽기
• 🔄 대용량 데이터 세트에 대한 자동 청킹
• 📑 시트 선택 및 행 페이지 매김
• 📅 적절한 날짜 처리
• ⚡ 대용량 파일에 최적화됨
• 🛡️ 오류 처리 및 검증

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 Excel Reader를 자동으로 설치하려면:

지엑스피1

MCP 서버로서

1. 전역적으로 설치:

2. MCP 설정 파일에 다음을 추가합니다(일반적으로 ~/.config/claude/settings.json 또는 이와 동등한 파일).

개발을 위해

1. 저장소를 복제합니다.

2. 종속성 설치:

3. 프로젝트를 빌드하세요:

용법

용법

Excel Reader는 다음 매개변수를 포함하는 단일 도구인 read_excel 제공합니다.

기본 사용법

Claude 또는 다른 MCP 호환 AI와 함께 사용하는 경우:

AI는 이 도구를 사용하여 파일을 읽고 큰 파일의 청킹을 자동으로 처리합니다.

특징

1. 자동 청킹
   • 대용량 파일을 관리하기 쉬운 청크로 자동 분할합니다.
   • 기본 청크 크기는 100KB입니다.
   • 페이지 매김을 위한 메타데이터를 제공합니다
2. 시트 선택
   • 이름으로 특정 시트 읽기
   • 지정하지 않으면 첫 번째 시트로 기본 설정됩니다.
3. 행 페이지 매김
   • startRow 및 maxRows를 사용하여 읽을 행을 제어합니다.
   • 연속 읽기를 위한 다음 청크 정보 가져오기
4. 오류 처리
   • 파일 존재 여부와 형식을 검증합니다.
   • 명확한 오류 메시지를 제공합니다
   • 잘못된 Excel 파일을 정상적으로 처리합니다.

SheetJS 기능으로 확장하기

Excel Reader는 SheetJS 기반으로 구축되었으며 강력한 기능으로 확장할 수 있습니다.

사용 가능한 확장 프로그램

1. 수식 처리
   // Enable formula parsing const wb = XLSX.read(data, { cellFormula: true, cellNF: true });
2. 셀 서식
   // Access cell styles and formatting const styles = Object.keys(worksheet) .filter(key => key[0] !== '!') .map(key => ({ cell: key, style: worksheet[key].s }));
3. 데이터 검증
   // Access data validation rules const validation = worksheet['!dataValidation'];
4. 시트 특징
   • 병합된 셀: worksheet['!merges']
   • 숨겨진 행/열: worksheet['!rows'] , worksheet['!cols']
   • 시트 보호: worksheet['!protect']

더 많은 기능과 자세한 설명서를 보려면 SheetJS 설명서를 방문하세요.

기여하다

1. 저장소를 포크하세요
2. 기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
3. 변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )
4. 브랜치에 푸시( git push origin feature/amazing-feature )
5. 풀 리퀘스트 열기

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

감사의 말

• SheetJS 로 구축됨
• 모델 컨텍스트 프로토콜 생태계의 일부