Skip to main content
Glama

Word 도구 MCP 서버

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

대장간 배지

특징

  • 전체 MCP 프로토콜 구현

  • Word 문서 생성 및 관리

  • 서식 있는 텍스트 콘텐츠 조작

  • 표 생성 및 서식 지정

  • 문서 레이아웃 제어

  • 문서 메타데이터 관리

  • 실시간 문서 상태 모니터링

Related MCP server: MCP Word Commander

필수 조건

  • Node.js 14 이상

  • Microsoft Word(선택 사항, 고급 기능용)

설치

지엑스피1

또는 전역적으로 설치:

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

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

npm install @puchunjie/doc-tools-mcp

용법

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

npx @puchunjie/doc-tools-mcp
  1. 서버는 기본적으로 포트 8765에서 시작됩니다.

  2. 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. 다음 구성을 추가합니다.

{
  "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 서버를 확장하거나 수정하려면:

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

git clone <repository-url>
cd doc-tools-mcp
  1. 종속성 설치:

npm install
  1. 개발 모드에서 시작:

npm run start
  1. 프로덕션을 위해 빌드:

npm run build

새로운 MCP 기능 추가

  1. src/services/DocumentService.ts 에 새로운 메서드를 추가합니다.

  2. src/mcp-server.ts 에 새로운 함수를 등록합니다.

  3. 필요에 따라 유형 정의를 업데이트합니다.

구성

  • 기본 포트: 8765(구성 가능)

  • 지원되는 파일 형식: .docx

  • 모든 파일 경로는 현재 작업 디렉토리를 기준으로 절대 경로이거나 상대 경로여야 합니다.

특허

MIT

지원하다

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

Available Tools

7 tools
add_paragraphD

Inputs: filePath (required), text (required), style, alignment.

add_tableD

Inputs: filePath (required), rows (required), cols (required), headers, +1 more.

create_documentD

Inputs: filePath (required), title, author.

get_document_infoD

Inputs: filePath (required).

open_documentD

Inputs: filePath (required).

search_and_replaceD

Inputs: filePath (required), searchText (required), replaceText (required), matchCase.

set_page_marginsD

Inputs: filePath (required), top, right, bottom, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2/5.0

    Scored across 7 tools

    Disambiguation4/5

    The tools have clearly distinct purposes targeting different document operations: creating documents, opening them, adding content (paragraphs/tables), modifying content (search/replace), adjusting layout (margins), and retrieving metadata. There is minor potential overlap between 'create_document' and 'open_document' if 'open' implies creation, but they are generally distinct.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with snake_case throughout (e.g., add_paragraph, create_document, get_document_info). There are no deviations in naming conventions, making the set predictable and readable.

    Tool Count5/5

    With 7 tools, this is a well-scoped set for a document management server. It covers core operations without being overly sparse or bloated, aligning with typical tool counts for focused domains like this.

    Completeness3/5

    The tools cover creation, opening, content addition, basic editing, layout adjustment, and info retrieval, but there are notable gaps. Missing operations include updating or deleting documents, managing document versions, or handling more complex formatting, which could limit agent workflows in a document management context.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers