doc-tools-mcp

Word 도구 MCP 서버

AI 기반 Word 문서 조작 기능을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 MCP 프로토콜을 구현하여 AI 애플리케이션이 자연어 상호작용을 통해 Word 문서를 생성, 편집 및 관리할 수 있도록 지원합니다.

특징

• 전체 MCP 프로토콜 구현
• Word 문서 생성 및 관리
• 서식 있는 텍스트 콘텐츠 조작
• 표 생성 및 서식 지정
• 문서 레이아웃 제어
• 문서 메타데이터 관리
• 실시간 문서 상태 모니터링

필수 조건

• Node.js 14 이상
• Microsoft Word(선택 사항, 고급 기능용)

설치

지엑스피1

또는 전역적으로 설치:

프로젝트의 종속성으로 사용하려면 다음을 수행하세요.

용법

1. MCP 서버를 시작합니다.

2. 서버는 기본적으로 포트 8765에서 시작됩니다.
3. MCP 서버를 사용하도록 AI 애플리케이션(예: Cursor, VSCode)을 구성합니다.
   http://localhost:8765

MCP 도구

서버는 다음과 같은 MCP 기능을 제공합니다.

• create_document - 새 Word 문서 만들기
  • 매개변수: filePath(필수), 제목, 작성자
• open_document - 기존 Word 문서 열기
  • 매개변수: filePath(필수)
• add_paragraph - 문서에 문단을 추가합니다.
  • 매개변수: filePath(필수), text(필수), style, alignment
• add_table - 문서에 표 추가
  • 매개변수: filePath(필수), rows(필수), cols(필수), headers, data
• search_and_replace - 문서에서 텍스트를 찾아 바꾸기
  • 매개변수: filePath(필수), searchText(필수), replaceText(필수), matchCase
• set_page_margins - 문서 페이지 여백 설정
  • 매개변수: filePath(필수), top, right, bottom, left
• get_document_info - 문서 메타데이터 가져오기
  • 매개변수: filePath(필수)

AI 애플리케이션과의 통합

커서

1. 커서 구성 파일 ~/.cursor/mcp.json 엽니다.
2. 다음 구성을 추가합니다.

또는 로컬 개발 버전의 경우:

구성 후 자연어를 사용하여 Word 문서를 조작할 수 있습니다.

VSCode 및 기타 MCP 호환 도구

MCP 프로토콜을 지원하는 다른 도구에도 유사한 통합 단계가 적용됩니다. 구체적인 MCP 서버 구성 단계는 해당 도구 설명서를 참조하십시오.

개발

이 MCP 서버를 확장하거나 수정하려면:

1. 저장소를 복제합니다.

2. 종속성 설치:

3. 개발 모드에서 시작:

4. 프로덕션을 위해 빌드:

새로운 MCP 기능 추가

1. src/services/DocumentService.ts 에 새로운 메서드를 추가합니다.
2. src/mcp-server.ts 에 새로운 함수를 등록합니다.
3. 필요에 따라 유형 정의를 업데이트합니다.

구성

• 기본 포트: 8765(구성 가능)
• 지원되는 파일 형식: .docx
• 모든 파일 경로는 현재 작업 디렉토리를 기준으로 절대 경로이거나 상대 경로여야 합니다.

특허

MIT

지원하다

문제가 발생하거나 개선에 대한 제안 사항이 있는 경우 GitHub 저장소에 문제를 제출해 주세요.