MCP Server Demo
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Server Demo add 5 and 3"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Related MCP server: FastMCP Training Course Server
๐ 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.gitGo to the project
cd mcp-server-demoInstall 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://SureshOutput
Hello, Suresh! Welcome to MCP.About Project
about://projectReturns 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.pyOpen 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
Available Tools
10 toolsaddA
Add two numbers.
Inputs: a (required), b (required). Returns: result
current_timeA
Return the current local time.
Inputs: no named parameters. Returns: result
divideB
Divide two numbers.
Inputs: a (required), b (required). Returns: result
lowercaseA
Convert text to lowercase.
Inputs: text (required). Returns: result
mock_weatherA
Return mock weather information.
Inputs: city (required). Returns: result
multiplyA
Multiply two numbers.
Inputs: a (required), b (required). Returns: result
reverse_textA
Reverse a string.
Inputs: text (required). Returns: result
subtractC
Subtract two numbers.
Inputs: a (required), b (required). Returns: result
uppercaseA
Convert text to uppercase.
Inputs: text (required). Returns: result
word_countB
Count the number of words.
Inputs: text (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
TDQS
Scored across 10 tools
Each tool performs a distinct, non-overlapping operation: arithmetic tools handle basic math, string tools handle text transformations, and time/weather are separate. No two tools could be confused for another.
All tool names use lowercase, verb-first conventions with clear actions (add, subtract, multiply, divide, word_count, uppercase, etc.). Compound names use underscores consistently, maintaining a uniform style.
With 10 tools covering arithmetic, string operations, time, and mock weather, the count is well-scoped for a demo server. Each tool has a clear purpose and none feel redundant or excessive.
The arithmetic set is complete with all four basic operations, and string operations cover common transformations. Missing operations like string concatenation or length are minor gaps for a demo, but the core surface is adequate.
Related MCP Connectors
Nifty's MCP server โ exposes tasks, projects, messages, and files as tools for AI agents.
A simple MCP server built with FastMCP and python
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA basic MCP server template that provides a foundation for building custom tools, resources, and prompts. Serves as a starting point for developers to create their own MCP server functionality.-
- FlicenseNot gradedqualityDmaintenanceAn educational MCP server example built with FastMCP that demonstrates how to expose tools, resources, and prompts to AI clients. Provides a learning foundation for building MCP servers with Python and integrating them with AI applications like IDEs and chatbots.-
- FlicenseNot gradedqualityDmaintenanceEducational example of an MCP server built with FastMCP, demonstrating how to expose tools, resources, and prompts for AI clients.-
- FlicenseNot gradedqualityDmaintenanceA simple MCP server demonstrating resources, tools, and prompts, including a greeting resource, an addition tool, and a calculation prompt.-