Community라이팅 & 에디팅github.com

Andrea201709/mcp-docs-toolkit

문서 워크플로우 검증, 패키징 및 유지보수를 위한 MCP 툴킷으로, Codex 친화적 검사를 포함합니다.

mcp-docs-toolkit란 무엇인가요?

이 스킬은 문서 워크플로우의 검증, 패키징 및 유지보수를 자동화하는 MCP(Model Context Protocol) 툴킷입니다. 주로 AI 코딩 에이전트(특히 Codex)와 함께 사용되며, 문서의 일관성, 형식, 링크 유효성 등을 자동으로 검사하여 문서 품질을 높이고 유지보수 비용을 줄입니다. 주요 기능으로는 문서 구조 검증, 패키징 포맷 변환, 배포 전 사전 검사(pre-flight checks) 등이 있습니다. 터미널 기반 CLI 도구로 동작하며, JSON 설정 파일을 통해 규칙을 사용자 정의할 수 있어 다양한 프로젝트에 유연하게 적용 가능합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add Andrea201709/mcp-docs-toolkit

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

mcp-docs-toolkit은(는) 무엇을 하나요?

문서 워크플로우 검증, 패키징 및 유지보수를 위한 MCP 툴킷으로, Codex 친화적 검사를 포함합니다.

개요

이 MCP 툴킷은 문서 중심 개발 워크플로우에서 발생하는 일반적인 문제를 해결합니다. 문서를 작성, 검증, 패키징하고 최종 배포 전에 일관성을 유지하도록 돕습니다. Codex와 같은 AI 코딩 에이전트와 함께 사용하도록 설계되어, 사람과 기계 모두가 읽을 수 있는 문서를 생성합니다.

주요 기능

  • 문서 검증: 잘못된 링크, 누락된 섹션, 일관성 없는 스타일 등을 검사합니다.
  • 패키징: 문서를 다양한 포맷(HTML, PDF 등)으로 변환합니다.
  • 워크플로우 유지보수: 문서 업데이트 시 기존 검증 규칙과 구조를 유지합니다.
  • Codex 친화적: AI 에이전트가 문서를 쉽게 분석하고 이해할 수 있도록 구조화합니다.

설치

npm install -g @andrea201709/mcp-docs-toolkit
# 또는
npx @andrea201709/mcp-docs-toolkit

사용법

기본 검증 실행:

mcp-docs-toolkit validate --path ./docs

패키징 실행:

mcp-docs-toolkit package --input ./docs --output ./dist

도움말 보기:

mcp-docs-toolkit --help

설정

프로젝트 루트에 mcp-docs-toolkit.config.json 파일을 생성하여 규칙을 사용자 정의할 수 있습니다:

{
  "validate": {
    "links": true,
    "headings": true,
    "tables": true
  },
  "package": {
    "format": "html",
    "outputDir": "./dist"
  }
}

환경 변수

  • MCP_DOCS_TOOLKIT_DIR: 설정 파일과 출력물의 기본 디렉토리 (~/.mcp-docs-toolkit)를 재정의합니다.

지원되는 플랫폼

  • Node.js 18 이상
  • macOS, Linux, Windows (WSL)
  • CI/CD 파이프라인 (GitHub Actions, GitLab CI 등)

라이선스

MIT

}

관련 스킬