Excel Reader 서버

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

특징

• Excel 파일의 모든 시트에서 콘텐츠 읽기

• 이름으로 특정 시트의 콘텐츠 읽기

• 인덱스별로 특정 시트의 콘텐츠 읽기

• JSON 형식으로 데이터를 반환합니다

• 빈 셀과 데이터 유형 변환을 처리합니다.

Related MCP server: Excel MCP Server

설치

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 파일을 참조하세요.

기여하다

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