de en es ja ko ru zh

MCP Weather and Currency Assistant

Name: MCP Weather and Currency Assistant
Author: adri14gl

by adri14gl

Overview Schema Source Related Servers Discussions Admin

Python

Hybrid

MCPを利用した金融・天気アシスタント

ローカルのMCPサーバーとOpenAI Responses APIを組み合わせたコマンドラインアプリケーションです。このアシスタントは自然言語のクエリを理解し、サーバーが公開するツールを自動検出して実行し、最新の為替レートと気象データを取得します。

このプロジェクトはFastMCP、ExchangeRate-API、Open-Meteoを統合しています。また、チェーン呼び出しにも対応しており、例えば都市名を座標に変換してから現在の天気や予報を取得することができます。

機能

ISO 4217コードによる通貨間の金額換算
基準通貨に対する為替レートの取得
都市のジオコーディング
現在の天気と1～7日先の予報の取得
クライアントによるMCPツールの自動検出
スペイン語の対話型ターミナルインターフェース
OpenAI呼び出し時の一時的なエラーに対するリトライとネットワークエラーの制御

Related MCP server: Weather MCP Server

アーキテクチャ

Usuario
  |
  v
CLI (main_client.py)
  |
  v
Cliente OpenAI Responses <----> Servidor MCP local (FastMCP)
                                      |
                                      +--> ExchangeRate-API
                                      +--> Open-Meteo

サーバーはデフォルトでHTTPトランスポートを使用し、http://127.0.0.1:8000/mcp/で公開されます。クライアントはこのURLに接続し、利用可能な5つのツールを読み込み、その結果をモデルに渡して最終的な応答を生成します。

MCPツール

ツール名	説明
`convert_currency`	現在のレートを使用して、2つの通貨間で金額を換算します。
`get_exchange_rates`	基準通貨に対する複数の通貨のレートを返します。
`geocode_city`	都市の座標、国、タイムゾーンを取得します。
`get_current_weather`	現在の気温、体感温度、湿度、風速、天気状態を取得します。
`get_weather_forecast`	今後数日間の気温、降水確率、天気状態を返します。

必要条件

Python 3.10以上
Responses APIにアクセスできるOpenAI APIキー
OpenAIおよび外部APIにアクセスするためのインターネット接続
ExchangeRate-APIのキーはオプションです。指定しない場合は公開エンドポイントを使用します。

インストール

リポジトリをクローンし、仮想環境を作成します：

git clone <URL_DEL_REPOSITORIO>
cd <NOMBRE_DEL_REPOSITORIO>
python -m venv .venv

仮想環境をアクティベートします：

# Windows PowerShell
.venv\Scripts\Activate.ps1

# Windows (cmd)
.venv\Scripts\activate.bat

# macOS/Linux
source .venv/bin/activate

依存関係をインストールします：

python -m pip install -r requirements.txt

設定

サンプル設定ファイルをコピーし、認証情報を記入します。.envファイルはローカル専用で、リポジトリに含めてはいけません：

Copy-Item .env.example .env

macOSまたはLinuxの場合：

cp .env.example .env

作成されたファイルには以下の変数が含まれている必要があります：

OPENAI_API_KEY=tu_clave_de_openai

# Opcional. Si se deja vacío se usa el endpoint abierto de ExchangeRate-API.
API_KEY_EXCHANGE=

# Opcionales.
MCP_HOST=127.0.0.1
MCP_PORT=8000
OPENAI_MODEL=gpt-4o-mini

OPENAI_API_KEYはクライアントを使用するために必要です。Open-Meteoは認証情報を必要としません。アプリケーションは外部HTTP呼び出しに10秒のタイムアウトを使用します。

使用方法

サーバーとクライアントは別々のターミナルで実行します。最初にサーバーを起動します：

python main_server.py

別のターミナルで、仮想環境をアクティベートした状態でクライアントを起動します：

python main_client.py

テスト

単体テストでは、OpenAIや外部APIを呼び出さずに、通貨ロジック、天気予報、WMOコード、エラー処理をカバーします：

python -m pip install -r requirements-dev.txt
python -m pytest

その後、以下のようなクエリを入力できます：

Convierte 100 USD a EUR
¿Cuál es el clima actual en Madrid?
Dame la previsión del tiempo para Nueva York durante 5 días
¿Qué coordenadas tiene Tokio?

CLIで使用可能なコマンド：

コマンド	アクション
`/ayuda`	ツールとクエリの例を表示します。
`/monedas`	一般的な通貨コードを表示します。
`/salir`	クライアントを終了します。

プロジェクト構造

.
├── .env.example          # Plantilla de configuración local
├── .gitignore            # Archivos excluidos del repositorio
├── client/
│   ├── cli_interface.py    # Interfaz interactiva de terminal
│   └── openai_client.py    # Orquestación OpenAI + MCP
├── config/
│   └── settings.py         # Variables de entorno y endpoints
├── server/
│   ├── api_clients.py      # Clientes HTTP para las APIs externas
│   ├── currency_tools.py   # Herramientas de divisas
│   ├── geocoding_tools.py  # Herramienta de geocodificación
│   ├── mcp_server.py       # Servidor FastMCP y registro de herramientas
│   └── weather_tools.py    # Herramientas meteorológicas
├── main_client.py          # Punto de entrada del cliente
├── main_server.py          # Punto de entrada del servidor
├── requirements.txt        # Dependencias de Python
└── README.md

外部API

OpenAI Responses API: クエリの解釈とツールの選択
ExchangeRate-API: 為替レートと換算
Open-Meteo: ジオコーディングと気象データ

結果はこれらのサービスの可用性、制限、利用規約に依存します。OpenAIの使用は、アカウントと設定されたモデルに応じてコストが発生する場合があります。

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

mcp-openaiOAuth
io.github.AceDataCloud
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
AI & Machine Learning Image & Video Processing
11
mcp-aichatOAuth
io.github.AceDataCloud
MCP server for AI dialogue using various LLM models via AceDataCloud
AI & Machine Learning
2
Weather MCP
io.github.kulybaba
An MCP server for weather information by @kulybaba
Weather Services Location Services
2
weather-mcp
io.github.kulybaba
An MCP server for weather information by @kulybaba
Weather Services Location Services
2

Related MCP Servers

Customized MCP Server
Weather Services Search
MorvanZhou
A
license
Not graded
quality
D
maintenance
A server that integrates the MCP library with OpenAI's API, allowing users to interact with various tools, such as the weather tool, through natural language queries.
Updated 2 years ago (2025-04-05 08:59 UTC)
MIT
Weather MCP Server
Weather Services
mkaohleaskhar
F
license
Not graded
quality
D
maintenance
Enables users to get current weather conditions and forecasts for any city through OpenWeatherMap API integration. Designed as a sample MCP server for the Puch AI Hackathon with basic weather querying capabilities.
Updated a year ago (2025-08-10 10:19 UTC)
-
Weather MCP
Weather Services Search
tengzhijian
A
license
Not graded
quality
D
maintenance
A MCP server for querying real-time weather information for any city worldwide using the free Open-Meteo API, supporting CLI and integration with AI clients like Claude and Cursor.
Updated 5 months ago (2026-05-06 02:16 UTC)
17 npm
MIT
mcp-poc
Weather Services Location Services
BhavanG
F
license
Not graded
quality
D
maintenance
A proof-of-concept MCP server that provides weather information using the Open-Meteo API, with tools for greeting, getting weather by coordinates, and by location name.
Updated 4 months ago (2026-06-27 06:41 UTC)
-