MCP Server Demo
A beginner-friendly MCP server demonstrating custom Tools, Resources, and Prompts using FastMCP.
README
MCP Server Demo with FastMCP
A beginner-friendly Model Context Protocol (MCP) server built using the official FastMCP Python SDK.
This project demonstrates the core concepts of MCP by implementing custom Tools, Resources, and Prompts, and testing them with MCP Inspector.
📌 Features
✅ Custom MCP Tools
- Addition
- Subtraction
- Multiplication
- Division
- Word Counter
- Uppercase Converter
- Lowercase Converter
- Reverse Text
- Current Time
- Mock Weather
✅ Dynamic Resources
- Greeting Resource
- About Project Resource
✅ Prompt Templates
- Greeting Prompt
- Summarization Prompt
- Explanation Prompt
📂 Project Structure
mcp-server-demo/
│
├── mcp.py
├── pyproject.toml
├── README.md
├── uv.lock
└── .venv/
⚙️ Requirements
- Python 3.11+
- uv
- MCP SDK
- FastMCP
📦 Installation
Clone the repository
git clone https://github.com/yourusername/mcp-server-demo.git
Go to the project
cd mcp-server-demo
Install dependencies
uv sync
▶️ Run the MCP Server
uv run mcp dev mcp.py
🛠 Available Tools
| Tool | Description |
|---|---|
| add | Add two numbers |
| subtract | Subtract two numbers |
| multiply | Multiply two numbers |
| divide | Divide two numbers |
| word_count | Count words |
| uppercase | Convert text to uppercase |
| lowercase | Convert text to lowercase |
| reverse_text | Reverse text |
| current_time | Show current time |
| mock_weather | Return mock weather information |
📄 Resources
Greeting
greeting://Suresh
Output
Hello, Suresh! Welcome to MCP.
About Project
about://project
Returns information about the project.
💬 Prompt Templates
greet_user
Generate a greeting prompt.
summarize_prompt
Generate a summarization prompt.
explain_prompt
Generate an explanation prompt.
🧪 Testing
Run the server
uv run mcp dev mcp.py
Open MCP Inspector
Test
- Tools
- Resources
- Prompts
🛠 Tech Stack
- Python
- FastMCP
- MCP SDK
- MCP Inspector
- uv
🎯 Learning Objectives
This project demonstrates
- MCP Fundamentals
- FastMCP
- Tools
- Resources
- Prompt Templates
- MCP Inspector
- Python MCP Server Development
📸 Screenshots
You can add screenshots of
- MCP Inspector
- Tools
- Resources
- Prompts
🚀 Future Improvements
- File Reader Tool
- JSON Formatter
- CSV Analyzer
- Markdown Converter
- UUID Generator
- Password Generator
- Notes Manager
- Weather API Integration
- Calculator Suite
- AI-powered Text Utilities
👨💻 Author
Sureshkumar
GitHub: https://github.com/Sureshkumar8795/mcp-server-demo.git
📄 License
MIT License
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
Neon Database
MCP server for interacting with Neon Management API and databases
E2B
Using MCP to run code via e2b.
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.