Markdown Word Counter Mcp

Markdown 字数统计 MCP 服务

一个用于统计 Markdown 文件字数的模型上下文协议（MCP）服务，支持统计中文字符和英文单词。

功能

• 精准统计字数：正确处理中文字符和英文单词
• 默认仅做最少处理：只规范化空白字符，保留所有内容
• 可配置处理方式：通过灵活选项控制处理内容
• 识别 Markdown 格式：可选择移除 Markdown 语法，同时保留内容
• 移除 HTML 标签：可选择从内容中移除 HTML 标签
• 处理链接：可选择提取 Markdown 链接中的文本
• 提供两种工具：
  • 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