Currency MCP Bot (学習プロジェクト)

Telegram Bot + 公開API + Docker/PostgreSQL + MCP + Cursor のシンプルな連携例です。

構成

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

Python Bot
   ↓
PostgreSQL
   ↑
   MCP
   ↑
Cursor

Related MCP server: postgres-mcp

Telegram Bot の役割

/start、/usd、/eur、/cny コマンドを受け付け、通貨のルーブルに対するレートを返します。

API の役割

ボットは無料の公開API（open.er-api.com）から最新レートを取得します。キー不要・登録不要です。

Docker の役割

docker compose が PostgreSQL をコンテナで起動します。ボット自体はローカルでPythonとして実行されます。

MCP の役割

MCPサーバーは Cursor に同じデータベースへの2つのツールを提供します:

1. get_recent_requests — ユーザーの最近のリクエスト

2. get_currency_stats — USD / EUR / CNY が何回尋ねられたか

ファイル

クイックスタート

1. Python の依存関係

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

2. 環境変数

サンプルをコピーしてボットのトークンを貼り付けます:

copy .env.example .env

.env に次の内容を入力します:

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

3. Docker で PostgreSQL を起動

docker compose up -d

確認:

docker compose ps

4. ボットの起動

python bot.py

Telegram でボットに /start を送信し、次に /usd、/eur、/cny を送信します。

5. Cursor での MCP

プロジェクトには .cursor/mcp.json があります。Windows では、サーバーが Connected リストに確実に表示されるよう、ユーザー用の ~/.cursor/mcp.json にも追加されています。

1. 最初に venv を作成し、依存関係をインストールします（上記ステップ1）

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

3. Settings → MCP を開きます

4. currency-bot-db を見つけます — ステータスが緑色で、tools: get_recent_requests、get_currency_stats となっているはずです。

サーバーがない場合やステータスが赤い場合は、PostgreSQL（docker compose ps）と .venv がインストールされていることを確認してください。

Telegram Bot Token の入手方法

1. Telegram を開いて @BotFather を探します

2. /newbot を送信します

3. ボットの名前と username を決めます

4. BotFather から 123456:ABC... のようなトークンが送られてきます

5. それを .env に TELEGRAM_BOT_TOKEN=... として貼り付けます

トークンを Git にコミットしないでください。.env ファイルはすでに .gitignore に含まれています。

Cursor での MCP へのテストリクエスト

ボットにいくつかコマンドを送信した後、Cursor のチャットに次のように書いてください:

• 「ユーザーの最近のリクエストを表示して」

• 「ユーザーが最もよくリクエストした通貨はどれ？」

• 「get_recent_requests を limit=5 で呼び出して」

• 「get_currency_stats を呼び出して」

Cursor は MCP ツールの get_recent_requests と get_currency_stats を使用します。