Skip to main content

A lightweight collection of reusable utility tools for the Model Context Protocol (MCP).

Project description

MCP Utility Tools

A lightweight collection of reusable utility tools for the Model Context Protocol (MCP).

Built using FastMCP and the Python standard library, this package provides common utilities that AI assistants and MCP clients can call without requiring external APIs or additional dependencies.

Features

  • 📏 Unit Conversion
  • 🔐 Secure Password Generator
  • 📅 Date Calculator
  • 🔑 Hash Generator
  • 🔤 Base64 Encode / Decode
  • 🆔 UUID Generator
  • 🔄 Text Case Converter
  • 📊 Text Statistics

Why this project?

This project was created as my first published PyPI package while learning the Model Context Protocol (MCP) ecosystem.

The goal was to build a practical MCP server exposing reusable utility tools using only Python's standard library.


Installation

pip install mcp-utility-tools
uv add mcp-utility-tools

Requirements

  • Python 3.11+
  • FastMCP

Available Tools

Tool Description
convert_units Convert between common units
generate_password Generate secure random passwords
date_calculator Date arithmetic
hash_text Generate hashes (SHA256, SHA512, MD5, etc.)
base64_convert Encode and decode Base64
generate_uuid Generate UUIDs
convert_case Convert text between naming styles
text_stats Analyze text statistics

Example

from mcp_utility_tools import main

main()

Example MCP tool call:

convert_units(
    value=5,
    from_unit="km",
    to_unit="mi"
)

Output:

5 km = 3.106856 mi

Technologies

  • Python
  • FastMCP
  • MCP
  • Standard Library

Roadmap

  • More unit categories
  • JSON outputs
  • Better error messages
  • Additional utility tools
  • Unit tests

Contributing

Contributions, feature requests and bug reports are welcome.

Feel free to open an issue or submit a pull request.


License

MIT License


Author

Dharsan

Connect me via

gmail: dharsanbalakrish@gmail.com LinkedIn: https://www.linkedin.com/in/dharsanbalakrish/

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_utility_tools-1.0.0.tar.gz (6.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcp_utility_tools-1.0.0-py3-none-any.whl (7.3 kB view details)

Uploaded Python 3

File details

Details for the file mcp_utility_tools-1.0.0.tar.gz.

File metadata

  • Download URL: mcp_utility_tools-1.0.0.tar.gz
  • Upload date:
  • Size: 6.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.13

File hashes

Hashes for mcp_utility_tools-1.0.0.tar.gz
Algorithm Hash digest
SHA256 165779a34c5c26ebc8bbd0f74acb792ec0497291fe7ca28ca2606f17428664c8
MD5 f5bbca5befd7a950e69091477357d900
BLAKE2b-256 47e25aa98f7f89e7dd1f9d4b6d6ac2e25d19fc9a90316c7694a15c0c23f95f2d

See more details on using hashes here.

File details

Details for the file mcp_utility_tools-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for mcp_utility_tools-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 248d77baa4fbb9e0cf534f1f598bbe4b5dde9bf5049064a091d4c96cc09f1b92
MD5 5fcac9fa849fbee7ca8ee7cf6c5e11dd
BLAKE2b-256 fcd0cdb24a68f17822268b836c3c2e086d83d1e6e5163dc501286f2a81214720

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page