mcp-markdown-tools

Markdown 콘텐츠 작업을 위한 도구를 제공하는 MCP(Model Context Protocol) 서버입니다. MCP 호환 클라이언트를 통해 프로그래밍 방식으로 Markdown을 분석, 린트, 서식 지정 및 생성할 수 있습니다.

도구

generate_toc

Markdown 제목에서 목차를 생성합니다. 최소/최대 제목 깊이를 구성하고 순서가 있는 목록 또는 순서가 없는 목록 출력 중에서 선택할 수 있습니다.

lint_markdown

깨진 링크 구문, 제목 계층 구조 위반, 후행 공백, 누락된 이미지 대체 텍스트, 일관되지 않은 목록 마커, 과도한 빈 줄 등 일반적인 문제를 Markdown에서 확인합니다.

format_markdown

Markdown 콘텐츠의 서식을 지정하고 정리합니다. 제목 스타일을 정규화하고(setext를 ATX로 변환), 제목과 블록 주변의 간격을 수정하며, 테이블 열을 정렬하고, 구성 가능한 너비로 긴 줄을 줄 바꿈합니다.

markdown_stats

Markdown 콘텐츠에서 상세 통계를 계산합니다: 단어 수, 문자 수, 예상 읽기 시간, 레벨별 제목, 링크 수, 이미지 수, 언어 분포를 포함한 코드 블록 수, 목록 항목, 인용문 및 단락 수.

generate_table

JSON 데이터에서 서식이 지정된 Markdown 테이블을 생성합니다. 열 선택, 사용자 지정 헤더 레이블 및 열별 정렬(왼쪽, 중앙, 오른쪽)을 지원합니다.

설치

npm install
npm run build

Claude Desktop에서 사용

Claude Desktop 구성 파일에 다음을 추가하세요:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "markdown-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-markdown-tools/dist/index.js"]
    }
  }
}

Claude Code에서 사용

Claude Code CLI를 사용하여 서버를 추가하세요:

claude mcp add markdown-tools node D:/products/mcp-servers/mcp-markdown-tools/dist/index.js

또는 .mcp.json 구성에 추가하세요:

{
  "mcpServers": {
    "markdown-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-markdown-tools/dist/index.js"]
    }
  }
}

개발

npm install
npm run build
npm start

라이선스

MIT