office-docs-mcp

# office_docs_mcp [](https://github.com/wkqco33/office_docs_mcp/actions/workflows/ci.yml) [](LICENSE) [](pyproject.toml) LLM(대형 언어 모델)이 오피스 문서(Excel, Word, PowerPoint)를 안정적이고 토큰 효율적으로 읽고 쓸 수 있도록 지원하는 **Model Context Protocol (MCP)** 서버입니다. > **버전 안내**: 본 프로젝트는 현재 초기 개발 단계(`0.y.z`)이며, 사용자 피드백에 따라 도구 인터페이스가 지속적으로 개선되고 있습니다. --- ## 주요 기능 - **Excel (`.xlsx`, `.xlsm`)**: - `excel_get_metadata`: 시트 목록, 크기, 컬럼 요약 조회 - `excel_read_sheet`: 지정된 행/열 범위(1-based)를 Markdown 테이블 또는 2차원 배열로 읽기 (수식/값 토글 지원) - `excel_search`: 워크시트 전체 또는 특정 시트의 셀에서 키워드 검색 - `excel_write_cell`: 단일 셀(`A1` 등) 값/수식 쓰기 (`backup=True` 지원) - `excel_write_range`: 시작 셀부터 2차원 데이터 연속 기입 (`backup=True` 지원) - `excel_append_rows`: 시트 마지막 행 뒤에 데이터 추가 (`backup=True` 지원) - `excel_manage_sheets`: 시트 추가(`add`), 이름변경(`rename`), 복사(`copy`), 삭제(`delete`) (`backup=True` 지원) - `excel_create_workbook`: 새 빈 엑셀 파일 생성 - **Word (`.docx`)**: - `word_get_outline`: 문서 헤딩(제목) 목록 및 단락/표 개수 조회 - `word_read_paragraphs`: 단락 슬라이싱 읽기 (0-based 페이징) - `word_read_table`: 표 내용을 Markdown 테이블 또는 2차원 배열로 읽기 - `word_search`: 문서 내 단락 및 표 셀 대상 키워드 검색 - `word_append_paragraph`: 문서 끝에 단락/헤딩 추가 (헤딩 레벨 자동 처리, `backup=True` 지원) - `word_append_table_row`: 특정 표에 새 행 추가 (`backup=True` 지원) - `word_write_table_cell`: 특정 표의 셀 텍스트 수정 (`backup=True` 지원) - `word_replace_text`: 문서 전체 텍스트 일괄/부분 치환 (`backup=True` 지원) - `word_delete_paragraph`: 특정 단락 삭제 (`backup=True` 지원) - `word_create_document`: 새 워드 문서 생성 - **PowerPoint (`.pptx`)**: - `ppt_get_outline`: 전체 슬라이드 수 및 각 슬라이드 제목/셰이프 요약 조회 - `ppt_read_slide`: 특정 슬라이드의 텍스트 상자, 표, 발표자 메모 내용 추출 - `ppt_read_notes`: 특정 슬라이드의 발표자 메모(Speaker Notes) 읽기 - `ppt_update_notes`: 발표 대본/슬라이드 메모 작성 및 수정 (`backup=True` 지원) - `ppt_search`: 슬라이드 텍스트, 표, 발표자 메모 대상 키워드 검색 …