Docx MCP 서비스

영어 | 중국어

Cursor의 AI 어시스턴트를 사용하여 Word 문서를 만들고, 편집하고, 관리할 수 있는 FastMCP 라이브러리 기반의 Docx 문서 처리 서비스입니다.

특징

• 완벽한 문서 작업 : 문서 생성, 열기, 저장은 물론 콘텐츠 추가, 편집, 삭제 지원
• 서식 : 글꼴, 색상, 크기, 정렬 및 기타 서식 옵션 설정 지원
• 테이블 처리 : 테이블 셀 생성, 편집, 병합 및 분할 지원
• 이미지 삽입 : 이미지 삽입 및 크기 설정 지원
• 레이아웃 제어 : 페이지 여백 설정, 페이지 나누기 추가 및 기타 레이아웃 요소 지원
• 쿼리 기능 : 문서 정보, 문단 내용 및 표 데이터 검색 지원
• 편리한 편집 : 찾기 및 바꾸기 기능 지원
• 섹션 편집 : 원래 서식과 스타일을 유지하면서 특정 섹션의 콘텐츠를 교체하는 기능 지원

설치 종속성

Python 3.10 이상이 설치되어 있는지 확인한 후 다음 종속성을 설치하세요.

지엑스피1

용법

Cursor에서 MCP 서비스로 사용

1. 커서를 열고 설정으로 이동하세요
2. Features > MCP Servers 섹션 찾기
3. Add new MCP server 클릭하세요.
4. 다음 정보를 입력하세요:
   • 이름: MCP_DOCX
   • 유형: 명령
   • 명령어: python3 /path/to/MCP_dox/server.py ( server.py 의 실제 경로로 대체)
5. Add 클릭하여 서비스를 추가하세요

추가한 후에는 Cursor의 AI 도우미에서 자연어를 사용하여 Word 문서를 조작할 수 있습니다. 예:

• "새 Word 문서를 만들어 바탕 화면에 저장하세요"
• "레벨 3 제목 추가"
• "3x4 표를 삽입하고 데이터를 채우세요"
• "두 번째 문단을 굵게, 가운데 정렬로 설정하세요"

지원되는 작업

이 서비스는 다음과 같은 작업을 지원합니다.

• 문서 관리 : create_document , open_document , save_document
• 콘텐츠 추가 : add_paragraph , add_heading , add_table , add_picture
• 콘텐츠 편집 : edit_paragraph , delete_paragraph , delete_text
• 테이블 작업 : add_table_row , delete_table_row , edit_table_cell , merge_table_cells , split_table
• 레이아웃 제어 : add_page_break , set_page_margins
• 쿼리 함수 : get_document_info , get_paragraphs , get_tables , search_text
• 파일 작업 : create_document , open_document , save_document , save_as_document , create_document_copy
• 섹션 편집 : replace_section , edit_section_by_keyword
• 기타 기능 : find_and_replace , search_and_replace (미리보기 기능 포함)

작동 원리

1. 이 서비스는 Python-docx 라이브러리를 사용하여 Word 문서를 처리합니다.
2. FastMCP 라이브러리를 통해 MCP 프로토콜을 구현하여 AI 어시스턴트와 통신합니다.
3. 요청을 처리하고 형식화된 응답을 반환합니다.
4. 완전한 오류 처리 및 상태 보고를 지원합니다.

타이포그래피 기능

이 서비스는 우수한 타이포그래피 이해 기능을 갖추고 있습니다.

• 텍스트 계층 구조 : 제목 수준(1-9) 및 단락 구성 지원
• 페이지 레이아웃 : 페이지 여백 설정 지원
• 시각적 요소 : 글꼴 스타일(굵게, 기울임꼴, 밑줄, 색상) 및 정렬 지원
• 표 레이아웃 : 표 만들기, 셀 병합, 표 분할, 표 형식 설정 지원
• 페이지 나누기 제어 : 페이지 나누기 추가 지원

개발 노트

• server.py - FastMCP 라이브러리를 사용한 MCP 서비스의 핵심 구현

문제 해결

커서에서 문제가 발생하면 다음 단계를 시도해 보세요.

1. Python 3.10+가 올바르게 설치되었는지 확인하세요.
2. python-docx 및 mcp 라이브러리가 올바르게 설치되었는지 확인하세요.
3. 서버 경로가 올바른지 확인하세요
4. 커서 애플리케이션을 다시 시작합니다.

노트

• python-docx 및 mcp 라이브러리가 올바르게 설치되었는지 확인하세요.
• 경로에 있는 중국어 문자가 올바르게 처리될 수 있는지 확인하세요.
• 절대 경로를 사용하면 경로 구문 분석 문제를 피할 수 있습니다.

특허

MIT 라이센스