Excel MCP 서버

간체 중국어 | 영어

MCP(Model Context Protocol) 기반의 Excel 파일 처리 서버로, Excel 파일을 읽고, 쓰고, 분석하는 기능을 제공합니다.

특징

• 📖 Excel 파일 읽기
  • 워크시트 목록 가져오기
  • 특정 워크시트 데이터 읽기
  • 모든 워크시트 데이터 읽기
• ✍️ Excel 파일 쓰기
  • 새로운 Excel 파일 만들기
  • 특정 워크시트에 쓰기
  • 여러 워크시트 지원
• 🔍 엑셀 구조 분석
  • 워크시트 구조 분석
  • 구조를 새 파일로 내보내기
• 💾 캐시 관리
  • 자동 파일 콘텐츠 캐싱
  • 예약된 캐시 정리
  • 수동 캐시 지우기
• 📝 로그 관리
  • 자동 작업 로깅
  • 정기적인 로그 정리

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 excel-mcp-server를 자동으로 설치하려면:

지엑스피1

수동 설치

NPM을 통해 설치하는 경우 MCP 서버 구성에 다음 구성을 추가하면 excel-mcp-server가 자동으로 설치될 수 있습니다.

Windows 플랫폼:

다른 플랫폼:

참고: LOG_PATH는 선택 사항입니다. 설정하지 않으면 로그는 애플리케이션 루트 디렉터리의 'logs' 폴더에 저장됩니다. 다른 인수는 선택 사항입니다.

API 도구

구조 도구

1. 분석Excel구조
   • 기능: JSON 형식의 시트 목록 및 열 머리글을 포함한 Excel 파일 구조 가져오기
   • 매개변수:
     • fileAbsolutePath: Excel 파일의 절대 경로
     • headerRows: 헤더 행 수(기본값: 1)
2. exportExcelStructure
   • 기능: Excel 파일 구조(시트 및 헤더)를 새 Excel 템플릿 파일로 내보내기
   • 매개변수:
     • sourceFilePath: 원본 Excel 파일 경로
     • targetFilePath: 대상 Excel 파일 경로
     • headerRows: 헤더 행 수(기본값: 1)

읽기 도구

1. 시트 이름 읽기
   • 기능: Excel 파일에서 모든 시트 이름 가져오기
   • 매개변수:
     • fileAbsolutePath: Excel 파일의 절대 경로
2. 시트 이름으로 데이터 읽기
   • 기능: Excel 파일의 특정 시트에서 데이터 가져오기
   • 매개변수:
     • fileAbsolutePath: Excel 파일의 절대 경로
     • sheetName: 읽을 시트의 이름
     • headerRow: 헤더 행 번호(기본값: 1)
     • dataStartRow: 데이터 시작 행 번호(기본값: 2)
3. 시트데이터 읽기
   • 기능: Excel 파일의 모든 시트에서 데이터 가져오기
   • 매개변수:
     • fileAbsolutePath: Excel 파일의 절대 경로
     • headerRow: 헤더 행 번호(기본값: 1)
     • dataStartRow: 데이터 시작 행 번호(기본값: 2)

쓰기 도구

1. writeDataBySheetName
   • 기능: Excel 파일의 특정 시트에 데이터 쓰기(시트가 있으면 덮어쓰기)
   • 매개변수:
     • fileAbsolutePath: Excel 파일의 절대 경로
     • sheetName: 작성할 시트의 이름
     • data: 쓸 데이터의 배열
2. writeSheetData
   • 기능: 제공된 데이터로 새 Excel 파일을 만듭니다.
   • 매개변수:
     • fileAbsolutePath: 새 Excel 파일의 절대 경로
     • 데이터: 여러 개의 시트 데이터를 포함하는 개체

캐시 도구

1. clearFileCache
   • 기능: 지정된 Excel 파일의 캐시된 데이터 지우기
   • 매개변수:
     • fileAbsolutePath: 캐시에서 지울 Excel 파일의 절대 경로

구성

환경 변수

• LOG_PATH : 로그 파일 저장 경로
  • 선택 과목
  • 기본값: 애플리케이션 루트 디렉토리 아래의 'logs' 폴더
• CACHE_MAX_AGE : 캐시 만료 시간(시간)
  • 선택 과목
  • 기본값: 1
• CACHE_CLEANUP_INTERVAL : 캐시 정리 간격(시간)
  • 선택 과목
  • 기본값: 4
• LOG_RETENTION_DAYS : 로그 보존 일수
  • 선택 과목
  • 기본값: 7
• LOG_CLEANUP_INTERVAL : 로그 정리 간격(시간)
  • 선택 과목
  • 기본값: 24

기본 구성

• 캐시 구성
  • 캐시 만료 시간: 1시간
  • 캐시 정리 간격: 4시간
• 로그 구성
  • 로그 보관 일수: 7일
  • 정리 간격: 24시간

종속성

• @modelcontextprotocol/sdk: ^1.7.0
• xlsx: ^0.18.5
• 타이프스크립트: ^5.8.2

개발 종속성

• @유형/노드: ^22.13.10
• 노드몬: ^3.1.9
• ts-노드: ^10.9.2

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 즉, 다음과 같은 작업을 자유롭게 수행할 수 있습니다.

• 상업적 또는 비상업적 목적으로 소프트웨어를 사용하십시오.
• 소스코드 수정
• 원본 또는 수정된 코드 배포 요구 사항:
• 원래 저작권 고지를 보관하세요
• 소프트웨어 사용에 대해 저자에게 어떠한 책임도 청구할 수 없습니다. 자세한 라이선스 정보는 LICENSE 파일을 참조하세요.