README.md•1.37 kB
# 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