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
multiplytool to compute the area: 14 × 11 = 154 - Calls the
multiplytool to get the carpet cost: 154 × 4.25 = 654.50 - Calls the
percentagetool to get the sales tax: 7.5% of 654.50 = 49.09 - Calls the
addtool 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 serverclient.py- Test clientrequirements.txt- Dependencies
Author: Dr. Wai Yan Nyein Naing