Markdown Word Counter Mcp

Markdown 単語カウンター MCP サーバー

Markdown ファイルの単語数をカウントする機能を提供する Model Context Protocol（MCP）サーバーです。中国語の文字と英単語の両方に対応しています。

機能

• 正確な単語数のカウント：中国語の文字と英単語の両方を適切に処理します
• デフォルトでは最小限の処理：空白のみを正規化し、すべてのコンテンツを保持します
• 設定可能な処理：柔軟なオプションで処理内容を制御できます
• Markdown に対応：コンテンツを保持したまま、Markdown 構文を任意で削除できます
• HTML タグの削除：コンテンツから HTML タグを任意で除去できます
• リンクの処理：Markdown リンクからテキストを任意で抽出できます
• 2 つのツールを利用可能：
  • count_words：オプションを指定して合計単語数を取得します
  • detailed_word_count：処理情報を含む詳細な統計を取得します

処理オプション

デフォルトでは、空白のみが正規化されます。それ以外の処理はすべて任意です。

• remove_html_tags（デフォルト：false）- <div>、<p> などの HTML タグを削除します
• process_markdown_links（デフォルト：false）- [text](url) リンクからテキストを抽出します
• remove_markdown_headers（デフォルト：false）- #、## などの見出し記号を削除します
• remove_markdown_lists（デフォルト：false）- -、*、+ などのリスト記号を削除します
• normalize_whitespace（デフォルト：true）- 連続するスペースや改行をまとめます

インストール

1. このリポジトリをクローンするか、ダウンロードします
2. 依存関係をインストールします：

   npm install
   

3. プロジェクトをビルドします：

   npm run build
   

使用方法

MCP サーバーとして使用

MCP クライアントの設定（例：mcp_settings.json）に追加します：

{
  "mcpServers": {
    "markdown-word-counter": {
      "command": "node",
      "args": [
        "/path/to/markdown-word-counter-mcp/build/index.js"
      ]
    }
  }
}

利用可能なツール

count_words

Markdown ファイルの合計単語数をカウントします。

パラメーター：

• file_path（string、必須）：Markdown ファイルへのパス
• remove_html_tags（boolean、任意）：HTML タグを削除します（デフォルト：false）
• process_markdown_links（boolean、任意）：Markdown リンクを処理します（デフォルト：false）
• remove_markdown_headers（boolean、任意）：見出しを削除します（デフォルト：false）
• remove_markdown_lists（boolean、任意）：リスト記号を削除します（デフォルト：false）
• normalize_whitespace（boolean、任意）：空白を正規化します（デフォルト：true）

例（デフォルト — 最小限の処理）：

{
  "file_path": "document.md"
}

例（すべての処理を有効化）：

{
  "file_path": "document.md",
  "remove_html_tags": true,
  "process_markdown_links": true,
  "remove_markdown_headers": true,
  "remove_markdown_lists": true
}

detailed_word_count

処理情報を含む、詳細な単語数の統計を取得します。

パラメーター：

• count_words と同じ

例：

{
  "file_path": "document.md",
  "remove_markdown_headers": false
}

単独での使用

サーバーを直接実行することもできます：

npm start

開発

• npm run dev：開発用の監視モードで実行します
• npm run build：TypeScript コードをビルドします
• npm start：ビルド済みのサーバーを実行します

単語数のカウントロジック

サーバーは次のロジックで単語数をカウントします。

1. HTML タグを削除：すべての HTML マークアップを除去します
2. Markdown リンクを処理：リンクテキストを抽出し、URL を削除します
3. Markdown 構文を削除：見出し（#）、リスト（-、*、+）
4. 空白を正規化：連続するスペースをまとめます
5. 個別にカウント：
   • 中国語の文字：Unicode 範囲 [\u4e00-\u9fa5] を使用します
   • 英単語：単語境界 \b\w+\b を使用します
6. 合計を算出：中国語の文字数 + 英単語数 = 合計単語数

例

デフォルトの処理（最小限 — 空白のみを正規化）

次の内容を含むファイルの場合：

# Hello 世界

This is a [link](http://example.com) with **bold** text.

- 中文测试
- English test

デフォルトの結果（すべての Markdown 構文を保持）：

• 中国語の文字数：4（中文测试）
• 英単語数：13（Hello This is a link http example com with bold text English test）
• 合計単語数：17

完全な処理（すべてのオプションを有効化）

同じファイルにすべての処理を適用した場合：

{
  "file_path": "document.md",
  "remove_html_tags": true,
  "process_markdown_links": true,
  "remove_markdown_headers": true,
  "remove_markdown_lists": true,
  "normalize_whitespace": true
}

すべての処理を適用した結果：

• 中国語の文字数：4（世界中文测试）
• 英単語数：7（Hello This is a link with bold text English test）
• 合計単語数：11

ライセンス

MIT