Local Utilities

A Python-based MCP server offering text, file, time, and security utilities via HTTP/stdio transport.

python

0

GitHub Stars

python

Language

6 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": {
    "aiforhumans-local-utils-mcp": {
      "command": "python",
      "args": [
        "server.py"
      ]
    }
  }
}

You run a local MCP server that exposes practical utilities for text, files, time, and security tasks. Built with FastMCP, it lets you perform common operations from a unified interface, making it easy to automate and integrate into your tools and workflows.

How to use

You connect to the server using an MCP client that supports stdio transports. Start by launching the server locally and then issue tool requests from your client. The server provides a suite of utilities such as temperature conversion, file operations, hashing, text analysis, date and time information, and password generation. Each tool returns structured results you can use in scripts, dashboards, or subsequent MCP actions.

How to install

# Prerequisites
- Python 3.8 or higher
- Access to a terminal/command prompt

# Optional: create and activate a virtual environment
python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS/Linux
source .venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Run the MCP server
python server.py

Configuration and usage notes

Configure your MCP clients to connect to the local server via stdio. The server is designed to run on the standard Python invocation and will listen through the local stdio channel when started with the command shown above.

LM Studio integration

{
  "mcpServers": {
    "local_utils": {
      "command": "python",
      "args": ["server.py"],
      "env": {}
    }
  }
}

Claude Desktop integration

{
  "mcpServers": {
    "local_utils": {
      "command": "python",
      "args": ["server.py"]
    }
  }
}

Available tools

convert_temp

Convert between Celsius and Fahrenheit with high-precision results (2 decimals).

read_file

Read the contents of a text file and return the full content.

write_file

Write content to a text file, creating any missing directories automatically.

list_directory

List directory contents with file sizes and icons.

calculate_hash

Compute MD5, SHA1, or SHA256 hashes for text or file contents.

base64_encode_decode

Encode or decode text using Base64.

get_datetime_info

Provide current date and time information with custom formatting.

text_stats

Analyze text to count lines, words, characters, and averages.

generate_password

Create secure random passwords with configurable character sets.