mozisu

Mozisu MCP Server counts characters and supports multi-byte Unicode, including Japanese text and emoji. It exposes multiple ways to interact: as an MCP server for LLM integration, via a CLI tool to count characters directly, and through a web interface for manual usage. To integrate with Claude Desktop or other MCP clients, run the MCP server so that it can respond to MCP protocol requests and provide the count_characters tool's results to the LLM. The included CLI tool (charcount) can be used stand-alone to count characters in a string or enter an interactive mode, while the web interface provides a browser-based way to count characters for given inputs. The server can be built and run from the repository, with the built binary placed in bin/mozisu-mcp-server and started to serve requests on the MCP port.

Prerequisites:

• Go 1.20+ installed
• Git
• Task (taskfile) for build workflow (as shown in the repo)

Installation steps:

1. Clone the repository: git clone https://github.com/Atotti/mozisu-mcp-server.git cd mozisu-mcp-server

2. Download dependencies: go mod download

3. Build the project (generally via the provided task): task build

4. Ensure the built binary exists at bin/mozisu-mcp-server. You can run the server directly: ./bin/mozisu-mcp-server

5. If you prefer to run via go directly (optional): go run cmd/mcpserver/main.go

Prerequisites recap: a Go toolchain, Git, and the project dependencies managed by go mod. The repository uses a build task to produce the mozisu-mcp-server binary which is then run as the MCP server.

Tips and notes:

• The MCP server exposes a command line tool (charcount) for counting characters directly. Use ./bin/charcount "your text" or run it in interactive mode with ./bin/charcount -i.
• The web interface is served by the built webserver binary (./bin/webserver) or via go run cmd/webserver/main.go, and is accessible at http://localhost:8080.
• When deploying, place the built mozisu-mcp-server binary in a stable path and reference it in your Claude Desktop configuration as the mcpServer entry, e.g., "/path/to/mozisu-mcp-server/bin/mozisu-mcp-server".
• If you rebuild, ensure you update any references to the binary path in Claude Desktop or other MCP clients.
• This server focuses on character counting, including multi-byte Unicode. If you extend functionality, consider adding additional tools or endpoints and updating the MCP protocol handlers accordingly.