MCP Server Example

🚀 Creating an MCP Server with Python - A Practical Tutorial

This repository demonstrates how to create an MCP (Model Context Protocol) server in Python using Microsoft's official SDK. The project shows how to define tools (@tool), which can be consumed by ChatGPT or other large language models in the Open WebUI environment.

🚀 Quick Start

This project showcases how to create an MCP server using Python and Microsoft's official SDK. It allows you to define tools that can be used by large language models.

✨ Features

• Demonstrates defining tools (@tool) for consumption by large language models.
• Supports both local testing and HTTP mode with OpenAPI documentation.

📦 Installation

# 1. Create a virtual environment using uv
uv venv .venv
source .venv/bin/activate

# 2. Install MCP SDK, CLI, and mcpo
uv add mcp mcp[cli] mcpo

📚 Documentation

🧩 Project Structure

📁 project/
├── main.py         # Main file containing the MCP server
├── README.md       # This file
└── .venv/          # Virtual environment (not under version control)

🛠️ Usage Examples

Basic Usage

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("Tutorial MCP Server")

@mcp.tool()
def get_tutorial_summary():
    """
    Return a summary of the tutorial on how to build an MCP server.

    :return: A text summary of the tutorial.
    """
    return (
        "Configure the environment using uv.\n"
        "Installation command: uv add mcp mcp[cli] mcpo\n"
        "Implement functions with @tool\n"
        "Running method: mcpo\n"
        "Consume via MCP client or Open WebUI."
    )

@mcp.tool()
def somar(a: int, b: int) -> int:
    """
    Return the sum of two integers.

    :param a: The first number.
    :param b: The second number.
    :return: The sum of a and b.
    """
    return a + b

if __name__ == "__main__":
    mcp.run(transport="stdio")  # Run locally

▶️ How to Run

🔹 Local Mode (stdio)

.venv/bin/python main.py

Or

mcp run main.py # Run the server in the standard way
mcp dev main.py # Test the server in developer mode
mcp install main.py # Install locally on Claude Desktop

This mode is suitable for local testing with the MCP CLI.

🔹 HTTP Mode with mcpo (OpenAPI Documentation)

mcpo --port 8000 -- .venv/bin/python main.py

• Automatically appears in the documentation.
• Serves as the basis for LLM usage based on user queries.

💡 Usage Tip

Clear docstrings can significantly enhance the interaction experience with LLMs.

🚀 Technologies Used

• Python 3.10+
• uv - Manage environments and packages
• mcp - Microsoft's official MCP SDK
• mcpo - HTTP middleware + OpenAPI documentation

📢 Contribution

Pull requests are welcome! Feel free to submit new tools, improve examples, or expand the tutorial.