MCP Server Tutorial

This repository contains a simple MCP (Model Context Protocol) server built with FastMCP. The server provides various mathematical operations as tools that can be used through the MCP protocol.

Features

• Basic arithmetic operations (addition, subtraction, multiplication, division)
• Advanced mathematical functions:
  • Power
  • Square root
  • Cube root
  • Factorial
  • Logarithm
  • Trigonometric functions (sin, cos, tan)
  • Remainder
• Dynamic greeting resource

Prerequisites

• Python 3.8 or higher
• FastMCP library

Installation

1. Clone this repository
2. Create and activate a virtual environment:

   uv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   

3. Install dependencies:

   uv install fastmcp
   

Usage

Running the Server

Run the server using:

python main.py

The server uses SSE (Server-Sent Events) transport by default, which allows you to connect using MCP Inspector.

Connecting with MCP Inspector

1. Open MCP Inspector

npx @modelcontextprotocol/inspector

3. Choose SSE Transport Type
4. Connect to the server URL (typically http://localhost:8000/sse)
5. You can now interact with the mathematical tools and resources defined in the server

Available Tools

• add(a, b): Adds two numbers
• subtract(a, b): Subtracts two numbers
• multiply(a, b): Multiplies two numbers
• divide(a, b): Divides two numbers
• power(a, b): Calculates a raised to the power of b
• sqrt(a): Calculates the square root of a number
• cbrt(a): Calculates the cube root of a number
• factorial(a): Calculates the factorial of a number
• log(a): Calculates the natural logarithm of a number
• remainder(a, b): Calculates the remainder when a is divided by b
• sin(a): Calculates the sine of a number
• cos(a): Calculates the cosine of a number
• tan(a): Calculates the tangent of a number

Available Resources

• greeting://{name}: Returns a personalized greeting for the given name

Modifying the Server

You can add more tools and resources by following the pattern in main.py:

1. To add a new tool, use the @mcp.tool() decorator
2. To add a new resource, use the @mcp.resource() decorator

Transport Options

FastMCP supports two transport protocols:

• stdio: Standard input/output (terminal-based)
• sse: Server-Sent Events (browser-based, compatible with MCP Inspector)

To change the transport protocol, modify the transport parameter in the mcp.run() call.