MCP FastMCP Demo Server

This project is a simple MCP (Model Context Protocol) server built using FastMCP.
It exposes:

• A tool (add)

• A dynamic resource (greeting://{name})

• A prompt (greet_user)

The server is designed to run over STDIO and can be inspected using the MCP Inspector UI.

📦 Prerequisites

Make sure you have the following installed:

All Platforms

• Python 3.9+

• Node.js 18+

• npm (comes with Node.js)

Check versions:

python --version
node --version
npm --version

🐍 Python Setup

1️⃣ Create a virtual environment (recommended)

Linux / macOS

python3 -m venv .venv
source .venv/bin/activate

Windows (PowerShell)

python -m venv .venv
.venv\Scripts\Activate.ps1

2️⃣ Install dependencies

pip install -r requirements.txt

(If using uv, make sure it’s already configured.)

▶️ Running the MCP Server with Inspector The MCP Inspector will start the server and connect to it automatically using STDIO.

Linux / macOS / Windows

npx @modelcontextprotocol/inspector python server.py

This will: Launch the Inspector UI Spawn python server.py and Connect via STDIO automatically.

📍 Inspector UI opens at:

http://localhost:5173 🧪 Verifying the Connection.

Once connected in the Inspector UI:

Tools

1. add(a: int, b: int) → int

2. Resources

3. greeting://{name}

4. Prompts

5. greet_user