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
- 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.json
is configured for this repo layout:command
: uv
args
: ["run", "src/mcp_charcount/server.py"]
This matches the current server which runs mcp.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