Excel MCP 서버

MS Excel 데이터를 읽고 쓰는 MCP(Model Context Protocol) 서버입니다.

특징

• MS Excel 파일에서 텍스트 값 읽기
• MS Excel 파일에 텍스트 값 쓰기
• MS Excel 파일에서 수식 읽기
• MS Excel 파일에 수식 쓰기
• MS Excel 파일에서 화면 이미지 캡처(Windows 전용)

자세한 내용은 도구 섹션을 참조하세요.

요구 사항

• Node.js 20.x 이상

지원되는 파일 형식

• xlsx(엑셀 책)
• xlsm(Excel 매크로 사용 책)
• xltx(Excel 템플릿)
• xltm(Excel 매크로 사용 템플릿)

설치

NPM을 통해 설치

excel-mcp-server는 다음 구성을 MCP 서버 구성에 추가하여 자동으로 설치됩니다.

Windows의 경우:

지엑스피1

다른 플랫폼의 경우:

Smithery를 통해 설치

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

read_sheet_names

Excel 파일에 있는 모든 시트 이름을 나열합니다.

인수:

• fileAbsolutePath
  • Excel 파일의 절대 경로

read_sheet_data

페이지 번호를 매겨 Excel 시트에서 데이터를 읽습니다.

인수:

• fileAbsolutePath
  • Excel 파일의 절대 경로
• sheetName
  • Excel 파일의 시트 이름
• range
  • Excel 시트에서 읽을 셀 범위(예: "A1:C10"). [기본값: 첫 번째 페이지 범위]
• knownPagingRanges
  • 이미 읽은 페이징 범위 목록

read_sheet_formula

페이지 번호를 매겨 Excel 시트에서 수식을 읽습니다.

인수:

• fileAbsolutePath
  • Excel 파일의 절대 경로
• sheetName
  • Excel 파일의 시트 이름
• range
  • Excel 시트에서 읽을 셀 범위(예: "A1:C10"). [기본값: 첫 번째 페이지 범위]
• knownPagingRanges
  • 이미 읽은 페이징 범위 목록

read_sheet_image

[Windows 전용] 페이지 번호를 사용하여 Excel 시트에서 이미지로 데이터를 읽습니다.

인수:

• fileAbsolutePath
  • Excel 파일의 절대 경로
• sheetName
  • Excel 파일의 시트 이름
• range
  • Excel 시트에서 읽을 셀 범위(예: "A1:C10"). [기본값: 첫 번째 페이지 범위]
• knownPagingRanges
  • 이미 읽은 페이징 범위 목록

write_sheet_data

Excel 시트에 데이터를 씁니다.

인수:

• fileAbsolutePath
  • Excel 파일의 절대 경로
• sheetName
  • Excel 파일의 시트 이름
• range
  • Excel 시트에서 읽을 셀 범위(예: "A1:C10").
• data
  • Excel 시트에 쓸 데이터

write_sheet_formula

Excel 시트에 수식을 작성합니다.

인수:

• fileAbsolutePath
  • Excel 파일의 절대 경로
• sheetName
  • Excel 파일의 시트 이름
• range
  • Excel 시트에서 읽을 셀 범위(예: "A1:C10").
• formulas
  • Excel 시트에 쓸 수식(예: "=A1+B1")

다음 환경 변수를 사용하여 MCP 서버 동작을 변경할 수 있습니다.

EXCEL_MCP_PAGING_CELLS_LIMIT

단일 페이징 작업에서 읽을 수 있는 셀의 최대 수입니다.
[기본값: 4000]

특허

Copyright (c) 2025 네고로 카즈키

excel-mcp-server는 MIT 라이선스 에 따라 출시됩니다.