Trading Economics Calendar Mcp

Trading Economics 日历 MCP 服务

一个模型上下文协议（MCP）服务，可访问 Trading Economics 的经济日历事件。此服务支持通过国家/地区、重要性级别和日期范围等多种筛选条件获取经济事件。

功能

• 📅 获取经济日历事件
• 🌍 按主要国家/地区筛选
• 📊 按重要性级别筛选（低、中、高）
• 📆 按日期范围筛选
• 🔍 筛选高影响力事件
• 🏛️ 按国家/地区查询事件

安装

从 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. Fork 此仓库
2. 创建功能分支
3. 进行修改
4. 添加测试
5. 运行测试套件
6. 提交拉取请求

许可证

MIT 许可证 — 详情请参阅 LICENSE 文件。

免责声明

此工具从 Trading Economics 获取公开数据。请遵守其服务条款和速率限制。此工具仅用于教育和研究目的。