Excel MCP 서버

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

특징

• 텍스트 값 읽기/쓰기

• 수식 읽기/쓰기

• 새 시트 만들기

🪟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를 자동으로 설치하려면:

excel_describe_sheets

지정된 Excel 파일의 모든 시트 정보를 나열합니다.

인수:

• fileAbsolutePath

  • Excel 파일의 절대 경로

excel_read_sheet

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

인수:

• fileAbsolutePath

  • Excel 파일의 절대 경로

• sheetName

  • Excel 파일의 시트 이름

• range

  • Excel 시트에서 읽을 셀 범위(예: "A1:C10"). [기본값: 첫 번째 페이지 범위]

• knownPagingRanges

  • 이미 읽은 페이징 범위 목록

• showFormula

  • 값 대신 수식을 표시합니다.

excel_screen_capture

[Windows 전용] 페이지 번호가 매겨진 Excel 시트의 스크린샷을 찍습니다.

인수:

• fileAbsolutePath

  • Excel 파일의 절대 경로

• sheetName

  • Excel 파일의 시트 이름

• range

  • Excel 시트에서 읽을 셀 범위(예: "A1:C10"). [기본값: 첫 번째 페이지 범위]

• knownPagingRanges

  • 이미 읽은 페이징 범위 목록

excel_write_to_sheet

Excel 시트에 값을 씁니다.

인수:

• fileAbsolutePath

  • Excel 파일의 절대 경로

• sheetName

  • Excel 파일의 시트 이름

• newSheet

  • true이면 새 시트를 만들고, 그렇지 않으면 기존 시트에 씁니다.

• range

  • Excel 시트에서 읽을 셀 범위(예: "A1:C10").

• values

  • Excel 시트에 쓸 값입니다. 값이 수식인 경우 "="로 시작해야 합니다.

excel_create_table

Excel 시트에 표 만들기

인수:

• fileAbsolutePath

  • Excel 파일의 절대 경로

• sheetName

  • 테이블이 생성된 시트 이름

• range

  • 범위가 테이블이 되도록 합니다(예: "A1:C10")

• tableName

  • 생성할 테이블 이름

excel_copy_sheet

기존 시트를 새 시트로 복사

인수:

• fileAbsolutePath

  • Excel 파일의 절대 경로

• srcSheetName

  • Excel 파일의 소스 시트 이름

• dstSheetName

  • 복사할 시트 이름

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

EXCEL_MCP_PAGING_CELLS_LIMIT

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

특허

Copyright (c) 2025 네고로 카즈키

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