MCP Wordcounter

🚀 MCP Word Counter

A Model Context Protocol server that provides text analysis tools, including word and character counting functions. This server assists LLMs (Large Language Models) in performing text analysis tasks by exposing simple document statistics functions.

🚀 Quick Start

The MCP Word Counter is a useful tool for text analysis, which can help LLMs perform relevant tasks.

✨ Features

• Count the number of words in a document.
• Calculate the total number of characters (including spaces).
• Determine the number of characters without spaces.
• Process files directly without exposing the content to LLMs.

📦 Installation

npm install mcp-wordcounter

💻 Usage Examples

Basic Usage

As a CLI Tool

npx mcp-wordcounter

Use in Claude Desktop

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

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

Advanced Usage

analyze_text

Perform word and character counting on a text file.

Parameters:

• filePath (string, required): The path of the text file to be analyzed.

Return Values:

• The number of words.
• The total number of characters including spaces.
• The total number of characters excluding spaces.

Example Response:

{
  "content": [{
    "type": "text",
    "text": "Analysis Results:\n• Number of Words: 150\n• Total Characters (including spaces): 842\n• Total Characters (excluding spaces): 702"
  }]
}

🔧 Technical Details

# Install dependencies
npm install

# Build the project
npm run build

# Enable hot reloading in development mode
npm run watch

# Test using the MCP inspector tool
npm run inspector

📄 License

This project is under the MIT License - see the LICENSE file for details.

🤝 Contributing

Contributions are welcome! Feel free to submit a Pull Request.