mcp-markdown-tools

Markdownコンテンツを操作するためのツールを提供するMCP（Model Context Protocol）サーバーです。MCP互換クライアントを通じて、Markdownの分析、リンティング、フォーマット、生成をプログラムで行うことができます。

ツール

generate_toc

Markdownの見出しから目次を生成します。見出しの最小/最大深度を設定し、順序付きリストまたは順序なしリストの出力を選択できます。

lint_markdown

リンク構文の破損、見出し階層の違反、末尾の空白、画像altテキストの欠落、リストマーカーの不整合、過剰な空行など、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