local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Provides the runtime environment for the MCP server, required as a prerequisite (version 14 or higher)

Word 도구 MCP 서버

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

특징

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

필수 조건

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

설치

지엑스피1

또는 전역적으로 설치:

npm install -g @puchunjie/doc-tools-mcp

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

npm install @puchunjie/doc-tools-mcp

용법

MCP 서버를 시작합니다.

npx @puchunjie/doc-tools-mcp

서버는 기본적으로 포트 8765에서 시작됩니다.
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 애플리케이션과의 통합

커서

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

{
  "mcpServers": {
    "doc-tools-mcp": {
      "command": "npx",
      "args": [
        "@puchunjie/doc-tools-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "doc-tools-mcp": {
      "command": "node",
      "args": [
        "/path/to/your/doc-tools-mcp/dist/mcp-server.js"
      ]
    }
  }
}

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

"Create a new document named report.docx"
"Add a heading 'Monthly Report' to report.docx"
"Insert a 4x3 table with sales data"

VSCode 및 기타 MCP 호환 도구

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

개발

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

저장소를 복제합니다.

git clone <repository-url>
cd doc-tools-mcp

종속성 설치:

npm install

개발 모드에서 시작:

npm run start

프로덕션을 위해 빌드:

npm run build

새로운 MCP 기능 추가

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

구성

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

특허

MIT

지원하다

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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

AI가 자연어를 통해 Word 문서를 읽고, 만들고, 수정할 수 있도록 합니다.

Related Resources

Reddit Discussion about this server