# Developer Utility MCP

A beginner-friendly Model Context Protocol (MCP) server built with Python to learn and demonstrate the core concepts of MCP through practical developer utilities.

This project focuses on understanding how an MCP-compatible AI host can discover and interact with **Tools, Resources, and Prompts** exposed by an MCP server.

---

## Overview

Developer Utility MCP is a local MCP server that provides a small collection of developer-focused capabilities such as UUID generation, hashing, JSON formatting, environment information, and reusable prompts.

The project was intentionally kept simple so the focus remains on understanding the MCP architecture and protocol flow.

It demonstrates:

- MCP Host / Client / Server architecture
- stdio transport
- MCP Tools
- MCP Resources
- MCP Prompts
- Tool discovery and invocation
- Input schemas
- Structured outputs
- Input validation
- Controlled error handling
- Logging and observability
- MCP Inspector testing
- Claude Desktop integration

---

## Architecture

```mermaid
flowchart TD
    A[User] --> B[Claude Desktop / MCP Inspector]

    B --> C[MCP Client]

    C -->|stdio| D[Developer Utility MCP Server]

    D --> E[Tools]
    D --> F[Resources]
    D --> G[Prompts]

    E --> E1[get_current_status]
    E --> E2[generate_uuid]
    E --> E3[calculate_hash]
    E --> E4[format_json]

    F --> F1[dev://environment]
    F --> F2[dev://python-version]

    G --> G1[explain_environment]
    G --> G2[explain_text]