MCP 엑셀 리더

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

특징

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

Related MCP server: Excel MCP Server

설치

Smithery를 통해 설치

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

지엑스피1

MCP 서버로서

전역적으로 설치:

npm install -g @archimdescrypto/excel-reader

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

{ "mcpServers": { "excel-reader": { "command": "excel-reader", "env": {} } } }

개발을 위해

저장소를 복제합니다.

git clone https://github.com/ArchimdesCrypto/mcp-excel-reader.git cd mcp-excel-reader

종속성 설치:

npm install

프로젝트를 빌드하세요:

npm run build

용법

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

interface ReadExcelArgs { filePath: string; // Path to Excel file sheetName?: string; // Optional sheet name (defaults to first sheet) startRow?: number; // Optional starting row for pagination maxRows?: number; // Optional maximum rows to read } // Response format interface ExcelResponse { fileName: string; totalSheets: number; currentSheet: { name: string; totalRows: number; totalColumns: number; chunk: { rowStart: number; rowEnd: number; columns: string[]; data: Record<string, any>[]; }; hasMore: boolean; nextChunk?: { rowStart: number; columns: string[]; }; }; }

기본 사용법

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

Read the Excel file at path/to/file.xlsx

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

특징

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

SheetJS 기능으로 확장하기

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

사용 가능한 확장 프로그램

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