Trading Economics Calendar Mcp

Trading Economics Calendar MCP Server

Trading Economics の経済カレンダーイベントにアクセスできる Model Context Protocol（MCP）サーバーです。このサーバーを使用すると、国、重要度、日付範囲などのさまざまなフィルターを指定して、経済イベントを取得できます。

特長

• 📅 経済カレンダーイベントの取得
• 🌍 主要国による絞り込み
• 📊 重要度（低・中・高）による絞り込み
• 📆 日付範囲による絞り込み
• 🔍 影響度の高いイベントによる絞り込み
• 🏛️ 国別のイベント検索

インストール

PyPI から（公開後）

pip install trading-economics-calendar-mcp

ソースから

git clone <repository-url>
cd trading-economics-calendar-mcp
pip install -e .

使用方法

MCP サーバーとして

サーバーを起動します：

trading-economics-mcp

利用可能なツール

1. 経済イベントを取得

get_economic_events(
    countries=["United States", "Germany"],
    importance="high",
    start_date="2024-01-01",
    end_date="2024-01-31"
)

2. 今日のイベントを取得

get_today_economic_events(
    countries=["United States"],
    importance="medium"
)

3. 今週のイベントを取得

get_week_economic_events(
    countries=["Japan", "United Kingdom"],
    importance="high"
)

4. 主要国を取得

get_major_countries()
# Returns: {"united_states": "United States", "germany": "Germany", ...}

5. 重要度を取得

get_importance_levels()
# Returns: {"low": 1, "medium": 2, "high": 3}

6. 影響度の高いイベントを取得

get_high_impact_events(
    countries=["United States", "China"],
    start_date="2024-01-01",
    end_date="2024-01-31"
)

7. 国別にイベントを取得

get_events_by_country(
    country="United States",
    start_date="2024-01-01",
    end_date="2024-01-07",
    importance="high"
)

対応国

このサーバーでは、主要経済国による絞り込みに対応しています：

• アメリカ合衆国
• 中国
• 日本
• ドイツ
• イギリス
• フランス
• イタリア
• カナダ
• オーストラリア
• ブラジル
• インド
• ロシア
• 韓国
• スペイン
• メキシコ
• オランダ
• スイス
• ベルギー
• スウェーデン
• オーストリア

レスポンス形式

各経済イベントは、次の構造で返されます：

{
    "date": "2024-01-15",
    "time": "08:30",
    "country": "United States",
    "event": "Retail Sales",
    "importance": 3,
    "actual": "0.6%",
    "forecast": "0.4%",
    "previous": "0.3%"
}

設定

サーバーでは、次のデフォルト設定を使用します：

• ベース URL：https://tradingeconomics.com
• リクエストのタイムアウト：30 秒
• ユーザーエージェント：最新のブラウザー文字列

エラー処理

サーバーには、包括的なエラー処理が含まれています：

• ネットワークのタイムアウト
• 無効なレスポンスの解析
• データフィールドの欠落
• レート制限（該当する場合）

開発

開発環境のセットアップ

git clone <repository-url>
cd trading-economics-calendar-mcp
pip install -e ".[dev]"

テストの実行

pytest

コードのフォーマット

black trading_economics_calendar/
flake8 trading_economics_calendar/
mypy trading_economics_calendar/

貢献

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更を加えます
4. テストを追加します
5. テストスイートを実行します
6. プルリクエストを送信します

ライセンス

MIT License - 詳細については LICENSE ファイルを参照してください。

免責事項

このツールは、Trading Economics が公開しているデータを取得します。同社の利用規約とレート制限を遵守してください。このツールは、教育および研究を目的としています。