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.