📌Overview

Purpose: To provide tools for analyzing text documents, facilitating word and character count for language models.

Overview: The MCP Word Counter is a server designed to assist in the analysis of text documents by offering essential statistics such as word and character counts. Its functionality is particularly beneficial for large language models (LLMs) that require concise document analysis without exposing the content.

Key Features:

• Word Counting: Accurately counts the total number of words in a document, aiding in text analysis and evaluation.

• Character Counting (including and excluding spaces): Provides detailed character count statistics, enhancing understanding of document length and structure.

• File Processing without Content Exposure: Allows for direct file processing, ensuring that the content remains secure and is not exposed to LLMs during analysis.

---

MCP Word Counter

A Model Context Protocol server that provides tools for analyzing text documents, including counting words and characters. This server helps LLMs perform text analysis tasks by exposing simple document statistics functionality.

Features

• Count words in documents
• Count total characters (including spaces)
• Count characters excluding spaces
• Process files directly without exposing content to LLMs

Installation

npm install mcp-wordcounter

Usage

As a CLI tool

npx mcp-wordcounter

In Claude Desktop

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "mcp-wordcounter": {
      "command": "npx",
      "args": ["-y", "mcp-wordcounter"],
      "alwaysAllow": ["analyze_text"]
    }
  }
}

Available Tools

analyze_text

Counts words and characters in a text document.

Parameters:

• filePath (string, required): Path to the text file to analyze

Returns:

• Word count
• Character count (including spaces)
• Character count (excluding spaces)

Example response:

{
  "content": [{
    "type": "text",
    "text": "Analysis Results:\n• Word count: 150\n• Character count (including spaces): 842\n• Character count (excluding spaces): 702"
  }]
}

Development

# Install dependencies
npm install

# Build the project
npm run build

# Run in watch mode during development
npm run watch

# Test with MCP Inspector
npm run inspector

License

MIT License - see LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.