Excel MCP Server

Microsoft Excel을 설치하지 않고도 Excel 파일을 조작할 수 있게 해주는 MCP(Model Context Protocol) 서버입니다. AI 에이전트로 Excel 통합 문서를 생성, 읽기 및 수정하세요.

기능

• 📊 Excel 작업: 통합 문서 및 워크시트 생성, 읽기, 업데이트

• 📈 데이터 조작: 수식, 서식, 차트, 피벗 테이블 및 Excel 표

• 🔍 데이터 유효성 검사: 범위, 수식 및 데이터 무결성을 위한 내장 유효성 검사

• 🎨 서식 지정: 글꼴 스타일, 색상, 테두리, 정렬 및 조건부 서식

• 📋 표 작업: 사용자 지정 스타일로 Excel 표 생성 및 관리

• 📊 차트 생성: 다양한 차트 유형 생성 (선형, 막대, 원형, 분산형 등)

• 🔄 피벗 테이블: 데이터 분석을 위한 동적 피벗 테이블 생성

• 🔧 시트 관리: 워크시트 복사, 이름 변경, 삭제를 간편하게 수행

• 🔌 3중 전송 지원: stdio, SSE(사용 중단 예정), 스트리밍 가능한 HTTP

• 🌐 원격 및 로컬: 로컬 및 원격 서비스로 모두 작동

Related MCP server: Excel MCP Server

사용법

이 서버는 세 가지 전송 방식을 지원합니다:

1. Stdio 전송 (로컬 사용용)

uvx excel-mcp-server stdio

{
   "mcpServers": {
      "excel": {
         "command": "uvx",
         "args": ["excel-mcp-server", "stdio"]
      }
   }
}

2. SSE 전송 (Server-Sent Events - 사용 중단 예정)

uvx excel-mcp-server sse

SSE 전송 연결:

{
   "mcpServers": {
      "excel": {
         "url": "http://localhost:8000/sse",
      }
   }
}

3. 스트리밍 가능한 HTTP 전송 (원격 연결 권장)

uvx excel-mcp-server streamable-http

스트리밍 가능한 HTTP 전송 연결:

{
   "mcpServers": {
      "excel": {
         "url": "http://localhost:8000/mcp",
      }
   }
}

환경 변수 및 파일 경로 처리

SSE 및 스트리밍 가능한 HTTP 전송

SSE 또는 스트리밍 가능한 HTTP 프로토콜로 서버를 실행할 때는 서버 측에서 EXCEL_FILES_PATH 환경 변수를 설정해야 합니다. 이 변수는 서버에 Excel 파일을 읽고 쓸 위치를 알려줍니다.

• 설정하지 않으면 기본값은 ./excel_files입니다.

• 이러한 전송 방식을 사용할 때 도구의 filepath 값은 해당 디렉토리에 대한 상대 경로여야 합니다(예: reports/q1.xlsx); 절대 경로 및 디렉토리 탐색은 거부됩니다.

또한 FASTMCP_PORT 환경 변수를 설정하여 서버가 수신 대기할 포트를 제어할 수 있습니다(설정하지 않으면 기본값은 8017입니다).

• 예시 (Windows PowerShell):

  $env:EXCEL_FILES_PATH="E:\MyExcelFiles"
  $env:FASTMCP_PORT="8007"
  uvx excel-mcp-server streamable-http

• 예시 (Linux/macOS):

  EXCEL_FILES_PATH=/path/to/excel_files FASTMCP_PORT=8007 uvx excel-mcp-server streamable-http

Stdio 전송

stdio 프로토콜을 사용할 때는 각 도구 호출 시 파일 경로가 제공되므로 서버에서 EXCEL_FILES_PATH를 설정할 필요가 없습니다. 서버는 각 작업에 대해 클라이언트가 보낸 경로를 사용합니다.

사용 가능한 도구

이 서버는 포괄적인 Excel 조작 도구 세트를 제공합니다. 모든 사용 가능한 도구에 대한 전체 문서는 TOOLS.md를 참조하세요.

스타 기록

라이선스

MIT 라이선스 - 자세한 내용은 LICENSE를 참조하세요.