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

Related MCP server: MCP Access Server

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.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