MCP Character Tools

🚀 MCP Character Tools

The ultimate solution for LLMs to handle individual characters and perform text analysis. An MCP server offering over 14 comprehensive character and text analysis tools.

🚀 Quick Start

The MCP Character Tools are essential for LLMs to interact with individual characters or perform tasks like counting specific letters in a word. It overcomes the limitations of LLMs caused by tokenization.

✨ Features

See the Difference

Why This Exists

First of all, why not? Second, Large Language Models tokenize text into subwords, not individual characters. For example, "strawberry" might become tokens like ["straw", "berry"], so the model never truly "sees" individual letters. This MCP server gives LLMs "character-level vision" through a suite of tools.

📦 Installation

Via npx (recommended)

npx mcp-character-tools

Via npm (global install)

npm install -g mcp-character-tools
mcp-character-tools

From source

git clone https://github.com/Aaryan-Kapoor/mcp-character-tools
cd mcp-character-tools
npm install
npm run build
npm start

💻 Usage Examples

Usage with Claude Desktop

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

{
  "mcpServers": {
    "char-tools": {
      "command": "npx",
      "args": ["mcp-character-tools"]
    }
  }
}

📚 Documentation

All Tools Reference

See sample_outputs.md for complete examples with inputs and outputs for all 14+ tools.

🔧 Technical Details

Development

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Development mode with auto-rebuild
npm run dev

Testing

The project includes comprehensive tests for all tools:

npm test

Test files:

• tests/counting.test.ts - Counting tools tests
• tests/spelling.test.ts - Spelling tools tests
• tests/analysis.test.ts - Analysis tools tests
• tests/tricky-words.test.ts - Tricky words resource tests
• tests/visualization.test.ts - Visualization utility tests

📄 License

MIT