Currency MCP Bot (Lernprojekt)

Ein einfaches Beispiel für die Kombination Telegram-Bot + öffentliche API + Docker/PostgreSQL + MCP + Cursor.

Schema

Telegram
   ↓
Python Bot
   ↓
API курса валют

Python Bot
   ↓
PostgreSQL
   ↑
   MCP
   ↑
Cursor

Related MCP server: postgres-mcp

Was der Telegram-Bot hier macht

Er nimmt die Befehle /start, /usd, /eur, /cny entgegen und antwortet mit dem Wechselkurs der Währung zum Rubel.

Was die API hier macht

Der Bot fragt den aktuellen Wechselkurs bei einer kostenlosen öffentlichen API (open.er-api.com) ab – ohne Schlüssel und ohne Registrierung.

Was Docker hier macht

docker compose startet PostgreSQL in einem Container. Der Bot selbst läuft lokal mit Python.

Was MCP hier macht

Der MCP-Server bietet Cursor zwei Tools für dieselbe Datenbank:

1. get_recent_requests – die letzen Anfragen der Benutzer

2. get_currency_stats – wie oft USD / EUR / CNY abgefragt wurden

Dateien

Schnellstart

1. Python-Abhängigkeiten

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt

2. Umgebungsvariablen

Kopieren Sie das Beispiel und fügen Sie den Bot-Token ein:

copy .env.example .env

Füllen Sie in .env aus:

TELEGRAM_BOT_TOKEN=ваш_токен_от_BotFather

3. PostgreSQL über Docker

docker compose up -d

Prüfung:

docker compose ps

4. Bot starten

python bot.py

Senden Sie dem Bot in Telegram /start, danach /usd, /eur, /cny.

5. MCP in Cursor

Im Projekt gibt es .cursomcp.json. Unter Windows wurde der Server zusätzlich in das benutzerspezifische ~/.cursomcp.json aufgenommen, damit er sicher in der Liste Connected erscheint.

1. Erstellen Sie zuerst eine venv und installieren Sie die Abhängigkeiten (Schritt 1 oben)

2. Ctrl+Shift+P → Developer: Reload Window

3. Öffnen Sie Settings → MCP

4. Suchen Sie currency-bot-db – der Status sollte grün sein, Tools: get_recent_requests, get_currency_stats

Wenn der Server fehlt oder der Status rot ist: prüfen Sie PostgreSQL (docker compose ps) und ob .venv installiert ist.

So erhalten Sie den Telegram-Bot-Token

1. Öffnen Sie Telegram und suchen Sie @BotFather

2. Senden Sie /newbot

3. Überlegen Sie sich einen Namen und einen Username für den Bot

4. BotFather sendet Ihnen einen Token der Form 123456:ABC...

5. Fügen Sie ihn in .env als TELEGRAM_BOT_TOKEN=... ein

Committen Sie den Token nicht in Git – die Datei .env ist bereits in .gitignore enthalten.

Testanfragen an MCP in Cursor

Nach ein paar Befehlen an den Bot schreiben Sie in den Cursor-Chat:

• „Zeig die letzen Anfragen der Benutzer“

• „Welche Währungen haben die Benutzer am häuftigsten angefragt?“

• „Ruf get_recent_requests mit limit=5 auf“

• „Ruf get_currency_stats auf“

Cursor solte die MCP-Tools get_recent_requests und get_currency_stats verwenden.