MCP Charcount Server

Provides a single MCP tool to count characters or bytes in text via stdio.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "torifukukaiou-mcp-charcount": {
      "command": "uv",
      "args": [
        "run",
        "src/mcp_charcount/server.py"
      ]
    }
  }
}

You run a lightweight MCP server that exposes a single tool to count characters or bytes in text. It is designed to be simple to start and easy to integrate with other MCP clients for quick text analysis tasks.

How to use

To use the server, run it as a local stdio MCP server so your client can talk to it directly on standard input/output.

Start the server for normal use:

run src/mcp_charcount/server.py

How to install

Prerequisites vary by your environment. At minimum you need the MCP runtime (uv) to run stdio servers and Python since the server script is Python.

Step by step to get started and run locally:

run src/mcp_charcount/server.py

If you want to develop with the MCP Inspector tooling, use this command instead:

run mcp dev src/mcp_charcount/server.py

Additional setup notes

Configuration and run flow details are available in the manifest that defines the MCP server as a stdio transport. The server runs with the following command and arguments, which you would typically place in your local MCP config.

{
  "mcpServers": {
    "mcp_charcount": {
      "command": "uv",
      "args": ["run", "src/mcp_charcount/server.py"]
    }
  }
}

Testing and development

You can verify the tool and its behavior with the project’s tests or simple runtime checks. To run tests without installing dependencies, you can use the test runner configured by the project, and with the runtime helper you can execute tests via the same MCP runtime.

-q

Notes on the available tool

Tool: count_chars is the single MCP tool exposed by this server. It accepts the following arguments and returns a structured result.

Arguments

text: string to analyze
mode: "chars" or "bytes" (default: "chars")
include_whitespace: boolean to include whitespace in the count (default: true)

Returns

{ "count": int, "mode": str, "include_whitespace": bool }

Available tools

count_chars

Counts characters or bytes in a given text, with options for mode and whitespace.