Remote MCP Server

A Python-based Model Context Protocol (MCP) server built with FastMCP that exposes mathematical operations, helper tools, and server metadata.

Features

Tools

1. add_two_numbers: Takes two floating-point numbers a and b, and returns their sum.
2. generate_random_number: Generates a random integer between 1 and 100 (inclusive).

Resources

1. info://server_info: Contains information/metadata about the running server (name, version, capabilities, status, and supported transports).

---

Installation

Ensure you have Python 3.13+ and the dependencies installed:

# Install dependencies using uv (or pip)
uv sync

---

Running the Server

You can run the server in two modes:

1. Stdio Mode (Default)

Standard input/output mode is ideal for local integration with MCP clients (like Claude Desktop).

# Direct run
.venv\Scripts\python main.py

# Or via FastMCP CLI
.venv\Scripts\fastmcp run main.py

2. SSE Mode (Remote/HTTP Mode)

To host the server as a web service accessible over HTTP via Server-Sent Events (SSE):

.venv\Scripts\fastmcp run main.py --transport sse --host 0.0.0.0 --port 8000

This will start the server binding on 0.0.0.0 at port 8000.

---

Verification & Testing

You can use the FastMCP inspect/dev tool to view and test the tools/resources:

.venv\Scripts\fastmcp dev main.py

This spins up a local web inspector where you can interactively invoke add_two_numbers and generate_random_number, and view the info://server_info resource.