local-only server

The server can only run on the client’s local machine because it depends on local resources.

MCP 엑셀 리더

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

특징

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

설치

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']

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

기여하다

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

특허

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

감사의 말

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

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

read_excel

MCP를 사용하여 시트 선택 및 오류 처리와 같은 원활한 파일 읽기 및 관리 기능을 활성화하고 자동 청크 및 페이지 분할을 통해 대용량 Excel 파일을 효율적으로 처리합니다.

Related Resources

Reddit Discussion about this server

MCP Excel Reader