local-only server

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

Integrations

Provides tools for reading and parsing Excel (.xlsx) files using Python, enabling extraction of data from entire workbooks or specific sheets by name or index.

Excel Reader 서버

Excel(xlsx) 파일을 읽기 위한 도구를 제공하는 MCP(Model Context Protocol) 서버입니다.

특징

Excel 파일의 모든 시트에서 콘텐츠 읽기
이름으로 특정 시트의 콘텐츠 읽기
인덱스별로 특정 시트의 콘텐츠 읽기
JSON 형식으로 데이터를 반환합니다
빈 셀과 데이터 유형 변환을 처리합니다.

설치

Python 3.10 이상이 필요합니다.

지엑스피1

종속성

mcp >= 1.2.1
오픈파이xl >= 3.1.5

용법

서버는 세 가지 주요 도구를 제공합니다.

1. 엑셀 읽기

Excel 파일의 모든 시트에서 내용을 읽습니다.

{
  "file_path": "path/to/your/excel/file.xlsx"
}

2. 시트 이름으로 Excel 읽기

특정 시트의 내용을 이름으로 읽습니다. 시트 이름이 지정되지 않으면 첫 번째 시트를 읽습니다.

{
  "file_path": "path/to/your/excel/file.xlsx",
  "sheet_name": "Sheet1"  # optional
}

3. 시트 인덱스로 엑셀 읽기

인덱스별로 특정 시트의 내용을 읽습니다. 인덱스가 지정되지 않으면 첫 번째 시트(인덱스 0)를 읽습니다.

{
  "file_path": "path/to/your/excel/file.xlsx",
  "sheet_index": 0  # optional
}

응답 형식

서버는 다음 JSON 형식으로 데이터를 반환합니다.

{
  "Sheet1": [
    ["Header1", "Header2", "Header3"],
    ["Value1", "Value2", "Value3"],
    ["Value4", "Value5", "Value6"]
  ]
}

각 시트는 최상위 개체의 키로 표현됩니다.
시트 데이터는 각 내부 배열이 행을 나타내는 배열의 배열입니다.
모든 값은 문자열로 변환됩니다.
빈 셀은 빈 문자열로 표현됩니다.

오류 처리

서버는 일반적인 문제에 대한 명확한 오류 메시지를 제공합니다.

파일을 찾을 수 없습니다
잘못된 시트 이름
인덱스가 범위를 벗어났습니다
일반적인 Excel 파일 읽기 오류

특허

이 프로젝트는 Apache 2 라이선스에 따라 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

Excel(xlsx) 파일을 읽고 전체 통합 문서나 특정 시트에서 데이터를 추출하고 결과를 구조화된 JSON 형식으로 반환할 수 있는 도구를 제공하는 MCP(Model Context Protocol) 서버입니다.

Related Resources

Reddit Discussion about this server

Excel Reader Server