FastMCP Dummy Server

Simple MCP Server

Author: Dr. Wai Yan Nyein Naing

A simple example of an MCP server for beginners.

Quick Start

1. Install

# Clone the repository
git clone https://github.com/WaiYanNyeinNaing/mcp-dummy-server.git
cd mcp-dummy-server

# Create virtual environment
python3.10 -m venv .venv
source .venv/bin/activate

# Install dependencies
pip install -r requirements.txt

2. Test

Option 1: Start server first (recommended for learning)

# Terminal 1: Start the server
python server.py

# Terminal 2: Run the client
python client.py

Option 2: Auto-start (client starts server automatically)

# Client automatically starts the server
python client.py

Example: Reasoning Calculation with LLM + MCP Tool

Suppose you ask an LLM:

"You're buying carpet for a rectangular room that's 14 feet by 11 feet. The carpet costs $4.25 per square foot. How much will the carpet cost, and if there's a 7.5% sales tax, what's your total cost?"

How the LLM solves it with MCP tools:

Calls the multiply tool to compute the area: 14 × 11 = 154
Calls the multiply tool to get the carpet cost: 154 × 4.25 = 654.50
Calls the percentage tool to get the sales tax: 7.5% of 654.50 = 49.09
Calls the add tool to get the total: 654.50 + 49.09 = 703.59

Final answer:

Carpet cost (before tax): $654.50
Sales tax: $49.09
Total cost: $703.59

Benefit:

By leveraging the MCP server's calculation tools, LLMs can solve real-world math and reasoning problems accurately, even for decimal and multi-step questions.

Integration

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "dummy": {
      "command": "/path/to/.venv/bin/python",
      "args": ["/path/to/server.py"],
      "cwd": "/path/to/mcp-dummy-server"
    }
  }
}

VS Code

Create .vscode/mcp.json:

{
  "servers": {
    "dummy": {
      "command": "/path/to/.venv/bin/python",
      "args": ["/path/to/server.py"],
      "cwd": "/path/to/mcp-dummy-server"
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "dummy": {
      "command": "/path/to/.venv/bin/python",
      "args": ["/path/to/server.py"],
      "cwd": "/path/to/mcp-dummy-server"
    }
  }
}

Files

server.py - The MCP server
client.py - Test client
requirements.txt - Dependencies

Author: Dr. Wai Yan Nyein Naing

This server cannot be installed

security - not tested

license - not found

quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A minimal example server implementing the Model Context Protocol, providing addition and multiplication tools for learning and experimentation with MCP clients.

Related MCP Servers

MCP-Guide
qpd-v
A
security
A
license
A
quality
A beginner-friendly Model Context Protocol (MCP) server that helps users understand MCP concepts, provides interactive examples, and lists available MCP servers. This server is designed to be a helpful companion for developers working with MCP. Also comes with a huge list of servers you can install.
Last updated -
3
9
36
JavaScript
Apache 2.0
Hello World MCP Server
jageenshukla
-
security
A
license
-
quality
A demonstration server that implements the Model Context Protocol (MCP) SDK, providing tools and endpoints for server-sent events and message handling.
Last updated -
27
TypeScript
MIT License
Echo MCP Server
piebro
A
security
A
license
A
quality
A simple server implementing the Model Context Protocol (MCP) that echoes messages back, designed for testing MCP clients.
Last updated -
1
Python
MIT License
MCP Server Basic Example
krishnaik06
-
security
-
license
-
quality
A simple implementation of a Model Context Protocol server that demonstrates core functionality including mathematical tools (add, subtract) and personalized greeting resources.
Last updated -
3
Python
GPL 3.0

View all related MCP servers

FastMCP Dummy Server

Simple MCP Server

Quick Start

1. Install

2. Test

Example: Reasoning Calculation with LLM + MCP Tool

Integration

Cursor

VS Code

Claude Desktop

Files

Related MCP Servers

MCP-Guide

Hello World MCP Server

Echo MCP Server

MCP Server Basic Example

New MCP Servers

MCP directory API