markdown

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