Skip to main content
Glama

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.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

F
license - not found
-
quality - not tested
B
maintenance

Maintenance

โ€“Maintainers
โ€“Response time
โ€“Release cycle
โ€“Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    -
    quality
    D
    maintenance
    A 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.
  • F
    license
    -
    quality
    D
    maintenance
    An 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.
  • F
    license
    -
    quality
    B
    maintenance
    A simple MCP server demonstrating resources, tools, and prompts, including a greeting resource, an addition tool, and a calculation prompt.

View all related MCP servers

Related MCP Connectors

  • MCP server for AI dialogue using various LLM models via AceDataCloud

  • MCP server for generating rough-draft project plans from natural-language prompts.

  • An MCP server for deep research or task groups

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Sureshkumar8795/mcp-server-demo'

If you have feedback or need assistance with the MCP directory API, please join our Discord server