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