Excel MCP 서버

👁 엔피엠
👁 대장간 배지
간체 중국어 | 영어

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

특징

• 📖 Excel 파일 읽기

  • 워크시트 목록 가져오기

  • 특정 워크시트 데이터 읽기

  • 모든 워크시트 데이터 읽기

• ✍️ Excel 파일 쓰기

  • 새로운 Excel 파일 만들기

  • 특정 워크시트에 쓰기

  • 여러 워크시트 지원

• 🔍 엑셀 구조 분석

  • 워크시트 구조 분석

  • 구조를 새 파일로 내보내기

• 💾 캐시 관리

  • 자동 파일 콘텐츠 캐싱

  • 예약된 캐시 정리

  • 수동 캐시 지우기

• 📝 로그 관리

  • 자동 작업 로깅

  • 정기적인 로그 정리

Related MCP server: Spire.XLS MCP Server

설치

Smithery를 통해 설치

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

지엑스피1

수동 설치

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

Windows 플랫폼:

{
 "mcpServers": {
 "excel": {
 "command": "cmd",
 "args": ["/c", "npx", "--yes", "@zhiweixu/excel-mcp-server"],
 "env": {
 "LOG_PATH": "[set an accessible absolute path]",
 "CACHE_MAX_AGE": "1",
 "CACHE_CLEANUP_INTERVAL": "4",
 "LOG_RETENTION_DAYS": "7",
 "LOG_CLEANUP_INTERVAL": "24"
 }
 }
}

다른 플랫폼:

{
 "mcpServers": {
 "excel": {
 "command": "npx",
 "args": ["--yes", "@zhiweixu/excel-mcp-server"],
 "env": {
 "LOG_PATH": "[set an accessible absolute path]",
 "CACHE_MAX_AGE": "1",
 "CACHE_CLEANUP_INTERVAL": "4",
 "LOG_RETENTION_DAYS": "7",
 "LOG_CLEANUP_INTERVAL": "24"
 }
 }
}

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

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• analyzeExcelStructureA
• clearFileCacheB
• exportExcelStructureA
• readDataBySheetNameC
• readSheetDataC
• readSheetNamesB
• writeDataBySheetNameC
• writeSheetDataB