Excel MCP Server

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 라이선스 에 따라 출시됩니다.