Zh Word Counter

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.