mcp-charcount
Simple MCP server that provides a single tool to count characters or bytes in text.
Quick start
-
Run with stdio (no PATH to python needed):
uv run src/mcp_charcount/server.py
-
Develop with MCP Inspector:
uv run mcp dev src/mcp_charcount/server.py
Tool: count_chars
- Args:
text: str,mode: "chars"|"bytes" = "chars",include_whitespace: bool = true - Returns:
{ "count": int, "mode": str, "include_whitespace": bool }
Tests
pytest -q(src layout is configured; install not required)- With uv:
uv run pytest -q
Manifest
mcp.jsonis configured for this repo layout:command:uvargs:["run", "src/mcp_charcount/server.py"]This matches the current server which runsmcp.run(transport='stdio')when executed as a script.
Settings Example
codex
~/.codex/config.toml
[mcp_servers.mcp-charcount]
command = "uv"
args = ["--directory", "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-charcount", "run", "src/mcp_charcount/server.py"]
Amazon Q Developer
~/.aws/amazonq/mcp.json
{
"mcpServers": {
"local.mcp-charcount": {
"command": "/opt/homebrew/bin/uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-charcount",
"run",
"src/mcp_charcount/server.py"
]
}
}
}
License: MIT