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