# 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`  

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

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