Skip to main content
Glama
Sign In
MCP Character Count

MCP Character Count

by TORIFUKUKaiou
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

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: Twitter MCP 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

Available Tools

1 tool
count_charsA
Count the length of input text.

- mode="chars": Unicode code points count (Python len).
- mode="bytes": UTF-8 encoded byte length.
- include_whitespace: when False, whitespace characters are filtered out before counting.

Inputs: text (required), mode, include_whitespace. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    TDQS

    A3.6/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of ambiguity or overlap between tools. The tool has a single, clearly defined purpose of counting characters in text.

    Naming Consistency5/5

    A single tool inherently has perfect naming consistency, as there are no other tool names to compare against. The name 'count_chars' follows a clear verb_noun pattern.

    Tool Count2/5

    A single tool for a character counting server feels thin and limited in scope. While the tool is functional, the server's purpose could reasonably support additional related operations (e.g., word counting, line counting, text analysis), making the single tool count appear underdeveloped.

    Completeness2/5

    The server's domain appears to be text analysis or character operations, but it only offers character counting with configurable modes. There are obvious gaps, such as no tools for word counting, line counting, text transformation, or other common text processing tasks, which limits its utility.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • MCP Character Counter

      MCP-Mirror
      F
      license
      Not graded
      quality
      Not graded
      maintenance
      Provides detailed character analysis for text, counting total characters, characters without spaces, letters, numbers, and symbols through a simple MCP tool interface.
      -

    • Twitter MCP Server

      serima
      A
      license
      A
      quality
      D
      maintenance
      Provides tools for accurate Twitter/X post character counting, validation, and optimization using official counting methods. It enables users to extract entities like URLs and hashtags to ensure content fits within platform constraints.
      4
      1
      MIT

    • text-count-mcp-server

      yuiseki
      A
      license
      Not graded
      quality
      D
      maintenance
      Provides tools for AI models to count characters and words in text, supporting English and other space-delimited languages.
      1
      MIT

    • Text Counter MCP Server

      gws8820
      A
      license
      A
      quality
      D
      maintenance
      Provides a tool to calculate basic text metrics including character count, characters without spaces, and word count.
      1
      12 PyPI
      MIT