Local Utilities

A comprehensiveModel Context Protocol (MCP)server built with FastMCP that provides essential utility tools for text processing, file operations, system tasks, and more.

- Convert between Celsius and Fahrenheit
- High precision calculations with 2 decimal places

- Readtext files with full content display
- Writecontent to files with automatic directory creation
- Listdirectory contents with file sizes and icons

- CalculateMD5,SHA1,SHA256hashes
- Hash text strings or entire file contents
- Base64encoding and decoding

- Count words, characters, and lines
- Calculate detailed text statistics
- Average words per line and characters per word

- Get current date and time information
- Custom formatting with Python strftime
- Detailed breakdown (year, month, day, weekday, etc.)

- Generate secure passwords with customizable options
- Control length and character sets
- Include/exclude uppercase, lowercase, numbers, symbols

- Python 3.8 or higher
- Compatible MCP client (LM Studio, Claude Desktop, etc.)

git clone https://github.com/aiforhumans/local-utils-mcp.git cd local-utils-mcp

Create and activate a virtual environment:

python -m venv .venv # Windows .venv\Scripts\activate # macOS/Linux source .venv/bin/activate

The server runs onstdiotransport by default, which is compatible with most MCP clients.

Add this configuration to your LM Studiomcp.jsonfile:

{ "mcpServers": { "local-utils": { "command": "python", "args": ["path/to/your/server.py"], "env": {} } } }

Add to your Claude Desktop configuration:

{ "mcpServers": { "local-utils": { "command": "python", "args": ["path/to/your/server.py"] } } }

Convert temperature between Celsius and Fahrenheit.

- value: Temperature value to convert
- unit: "C" for Celsius to Fahrenheit, "F" for Fahrenheit to Celsius

convert_temp(25, "C") → "77.00 °F" convert_temp(77, "F") → "25.00 °C"

Read and return the contents of a text file.

- file_path: Absolute or relative path to the file

Returns:File contents with path information

write_file(file_path: str, content: str)

Write content to a text file with automatic directory creation.

- file_path: Path where to write the file
- content: Text content to write

list_directory(directory_path: str = ".")

List contents of a directory with file sizes.

- directory_path: Path to directory (defaults to current directory)

Returns:Formatted list with file/folder icons and sizes

calculate_hash(text_or_path: str, hash_type: str = "sha256", is_file: bool = False)

Calculate cryptographic hash of text or file content.

- text_or_path: Text string or file path to hash
- hash_type: "md5", "sha1", or "sha256" (default)
- is_file: Set totruewhen hashing a file

base64_encode_decode(text: str, operation: str = "encode")

- text: Text to encode/decode
- operation: "encode" or "decode"

get_datetime_info(format_string: str = "%Y-%m-%d %H:%M:%S")

Get comprehensive current date and time information.

- format_string: Python strftime format string for custom formatting

Calculate detailed statistics for the given text.

Returns:Lines, words, characters, and averages

generate_password(length: int = 12, include_uppercase: bool = True, include_lowercase: bool = True, include_numbers: bool = True, include_symbols: bool = False)

- length: Password length (default: 12)
- include_uppercase: Include A-Z (default: true)
- include_lowercase: Include a-z (default: true)
- include_numbers: Include 0-9 (default: true)
- include_symbols: Include special characters (default: false)

Run the test suite to verify functionality:

This will test all core functions and verify the server can be imported correctly.

To extend the server with additional tools:
- Create a new functionwith the@mcp.tool()decorator:

@mcp.tool( description="Your tool description here" ) async def your_new_tool(param1: str, param2: int = 10) -> str: """ Your tool implementation. Args: param1: Description of parameter 1 param2: Description of parameter 2 with default value Returns: String result of the tool operation """ try: # Your tool logic here result = f"Processed {param1} with value {param2}" return result except Exception as e: return f"Error: {str(e)}"

- Add proper error handlingand meaningful return messages
- Update the READMEwith documentation for your new tool
- Test your toolto ensure it works correctly

local-utils-mcp/ ├── server.py # Main MCP server ├── requirements.txt # Python dependencies ├── README.md # This file ├── .gitignore # Git ignore rules ├── test.py # Test suite └── .venv/ # Virtual environment (not in git)

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
- Fork the repository
- Create your feature branch (git checkout -b feature/AmazingFeature)
- Commit your changes (git commit -m 'Add some AmazingFeature')
- Push to the branch (git push origin feature/AmazingFeature)
- Open a Pull Request

Seerequirements.txtfor complete dependency list.

This project is licensed under the MIT License - see theLICENSEfile for details.

- FastMCP- The FastMCP framework used to build this server
- Model Context Protocol- Official MCP documentation
- LM Studio- Popular MCP client for local AI models

A cross-platform filesystem server for Linux, macOS, and Windows with secure path restrictions.