# 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

```bash
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

```python
from mcp_utility_tools import main

main()
```

Example MCP tool call:

```text
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/