Dummy MCP Server (Contabo + Hetzner)
This project is a dummy MCP server built for interview/demo purposes.
It simulates the behavior of an MCP (Model Control Plane) server that connects to service providers like Contabo and Hetzner, but without calling real APIs.
Why dummy Service providers?
Since, in order to utilize Contabo and Hetzner services, we have to go through payment and billing. Therefore, to understand the basic working of MCP with service providers, we created fake instances!
Purpose
The goal of this project is to demonstrate:
- Clean architecture
- Request routing logic
- Provider-based service modules
- Working client-server flow
- Frontend dialog response display
- Interview-ready demo
Features
✔ Dummy MCP server with clean request routing
✔ Two service providers (Contabo & Hetzner)
✔ Dummy “create_server” & “delete_server” actions
✔ Frontend UI with dialog box to show response
✔ CORS enabled for browser requests
✔ Easy to extend (add real APIs later)
Architectural Diagram
┌─────────────────────┐
│ MCP Client │
│ (Frontend / CLI) │
└─────────┬───────────┘
│ POST /mcp
│
┌──────────▼───────────┐
│ MCP Server │
│ (FastAPI) │
└──────────┬───────────┘
│
┌───────────────┴───────────────┐
│ │
┌───────▼────────┐ ┌────────▼───────┐
│ ContaboService │ │ HetznerService │
│ (Dummy Logic) │ │ (Dummy Logic) │
└────────────────┘ └────────────────┘
Step-by-Step Setup (Commands Used)
1. Create project folder
mkdir mcp-server
cd mcp-server
2. Initialize Git
git init
3. Create Python Virtual Environment
python3 -m venv venv
source venv/bin/activate
4. Install dependencies
pip install fastapi uvicorn
5. Save dependencies
pip freeze > requirements.txt
6. Create folders & files
mkdir services
touch main.py
touch services/contabo.py
touch services/hetzner.py
touch index.html
touch README.md
Running the Server
uvicorn main:app --reload --port 3000
You should see:
INFO: Uvicorn running on http://127.0.0.1:3000
Testing via Curl (Contabo)
curl -X POST http://localhost:3000/mcp \
-H "Content-Type: application/json" \
-d '{
"provider": "contabo",
"action": "create_server",
"payload": {"name": "test-server", "ram": "4GB"}
}'
Testing via Curl (Hetzner)
curl -X POST http://localhost:3000/mcp \
-H "Content-Type: application/json" \
-d '{
"provider": "hetzner",
"action": "create_server",
"payload": {"name": "hetzner-server", "ram": "8GB"}
}'
Frontend Demo
Open index.html in your browser and:
- Select Provider
- Select Action
- Enter Payload
- Click Send Request
- Response appears in a dialog box
Logic Explanation
1. MCP Server (main.py)
- Receives POST request at
/mcp - Checks provider name
- Routes request to respective service module
2. Contabo Service (services/contabo.py)
- Simulates server creation & deletion
- Returns fake server ID
3. Hetzner Service (services/hetzner.py)
- Same dummy logic as Contabo
GitHub Push Commands
git add .
git commit -m "Initial dummy MCP server implementation"
git branch -M main
git remote add origin https://github.com/<your-username>/mcp-server.git
git push -u origin main