Zh Word Counter

Name: Zh Word Counter
Author: yoqu

@yoqu

代码仓库

关于 Zh Word Counter

暂无概览

#zh-word-counter #word-counter #character-counting

基本信息

分类

其他

传输方式

stdio

发布者

yoqu

提交者

Lin Yoqu

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "word-counter": {
      "command": "npx",
      "args": [
        "@yoqulin/mcp-word-counter@latest"
      ]
    }
  }
}

工具

统计文件中的中文字数。支持单个或多个文件路径。计算规则：汉字=1，英文字符=0.5，全角字符=1，半角字符=0.5，结果向上取整。

概览

What is Zh Word Counter?

Zh Word Counter is an MCP server that counts Chinese and English characters with smart recognition. It supports Chinese characters, English letters, full‑width and half‑width characters, and provides detailed per‑file and total statistics. It is intended for developers and writers who need accurate word counts for Chinese text.

How to use Zh Word Counter?

Install via npx mcp-word-counter or npm install -g mcp-word-counter. Configure the MCP client with the correct command and no environment variables. Invoke the count_words tool with a filePaths array (e.g., { "filePaths": ["./example.txt"] }) to count words in one or more text files.

Key features of Zh Word Counter

Smart character recognition (Chinese, English, full‑half width)
Multi‑file support with a single call
Detailed per‑character‑type statistics
Weighted calculation with rounding up
Friendly error handling and prompts

Use cases of Zh Word Counter

Counting Chinese characters in a document or article
Analyzing character mix for localization or content management
Batch‑counting multiple text files (e.g., reports, source code)
Validating word count constraints in Chinese‑language publishing

FAQ from Zh Word Counter

What character types does the server recognize?

It recognizes Chinese characters, English letters (a–z, A–Z), full‑width characters, half‑width characters, and other characters.

How is the word count calculated?

Each character type has a weight: Chinese and full‑width = 1.0, English and half‑width = 0.5. The total is the weighted sum, then rounded up (e.g., 3.2 → 4).

Can I count words in multiple files at once?

Yes, pass an array of file paths to the filePaths parameter. The server returns per‑file details and a grand total.

What file formats are supported?

Any text‑based file: .txt, .md, .js, .ts, .json, and others.

How do I install and configure it?

Use npx mcp-word-counter or install globally with npm install -g mcp-word-counter. Add a mcpServers entry in your MCP client configuration with the appropriate command and no env object.