MCP Server Tutorial 7f7

🚀 MCP Server Tutorial

This repository contains a simple MCP (Model Context Protocol) server built with FastMCP. The server offers various mathematical operations as tools, which can be used via the MCP protocol.

🚀 Quick Start

This server provides a range of mathematical operation tools. You can connect to the server using MCP Inspector and interact with these tools and resources.

✨ Features

• Basic Arithmetic Operations: Addition, subtraction, multiplication, and division.
• Advanced Mathematical Functions:
  • Exponentiation
  • Square root
  • Cube root
  • Factorial
  • Logarithm
  • Trigonometric functions (sine, cosine, tangent)
  • Modulus
• Dynamic Greeting Resources

📦 Installation

Prerequisites

• Python 3.8 or higher
• FastMCP library

Steps

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

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

3. Install the dependencies:

   uv install fastmcp
   

💻 Usage Examples

Running the Server

Use the following command to run the server:

python main.py

The server uses SSE (Server-Sent Events) for transmission by default, so you can connect to it using MCP Inspector.

Connecting with MCP Inspector

1. Open MCP Inspector:

npx @modelcontextprotocol/inspector

2. Select the SSE transmission type.
3. Connect to the server URL (usually http://localhost:8000/sse).
4. Now you can interact with the mathematical tools and resources defined by the server.

Available Tools

• add(a, b): Add two numbers.
• subtract(a, b): Subtract two numbers.
• multiply(a, b): Multiply two numbers.
• divide(a, b): Divide one number by another.
• power(a, b): Calculate a to the power of b.
• sqrt(a): Calculate the square root of a number.
• cbrt(a): Calculate the cube root of a number.
• factorial(a): Calculate the factorial of a number.
• log(a): Calculate the natural logarithm of a number.
• remainder(a, b): Calculate the remainder of a divided by b.
• sin(a): Calculate the sine of a number.
• cos(a): Calculate the cosine of a number.
• tan(a): Calculate the tangent of a number.

Available Resources

• greeting://{name}: Return 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.