🚀 天气机器人与 OpenAI 代理 SDK

本项目是一个 Telegram 机器人，借助 OpenAI 的代理 SDK 和模型上下文协议（MCP），为用户提供实时天气信息。它支持通过自然语言查询全球任意城市的当前天气状况，由 GPT - 4o - mini 模型驱动。

✨ 主要特性

• 实时天气数据获取：利用 Open - Meteo API 实现。
• 自然语言处理：借助 OpenAI 代理 SDK（GPT - 4o - mini），可处理自然语言查询。
• MCP 服务器实现：有简单的 MCP 服务器，用于获取天气数据。
• 原生 Telegram 消息格式输出：以 Telegram 原生消息格式呈现查询结果。
• 易用界面：支持简单的天气查询，操作便捷。

📦 安装指南

1. 克隆仓库：

git clone https://github.com/esakrissa/agents-sdk-telegram.git
cd agents-sdk-telegram

2. 创建并激活虚拟环境：

python -m venv venv
source venv/bin/activate  # Windows 用户请使用：venv\Scripts\activate

3. 安装依赖项：

pip install -r requirements.txt

4. 创建 .env 文件：在项目根目录下创建 .env 文件，并添加以下内容：

TELEGRAM_BOT_TOKEN=你的机器人令牌
OPENAI_API_KEY=你的 OpenAI API 密钥

5. 运行机器人：

python main.py

💻 使用示例

基础用法

只需向机器人发送一条消息，询问任意城市的天气情况即可，例如：

乌布的天气怎么样？

机器人将回复当前天气状况，包括：

• 温度
• 天气状况描述
• 风速

🔧 技术细节

OpenAI 代理 SDK 集成

该机器人使用 OpenAI 的代理 SDK 和 GPT - 4o - mini 模型来处理自然语言查询并生成人类可读的回复。代理根据指令处理天气相关查询，并维护对话上下文。

模型上下文协议（MCP）

项目实现了一个简单的 MCP 服务器 (weather_mcp.py)，提供 get_weather 工具。这展示了如何：

• 创建自定义 MCP 工具
• 处理工具请求和响应
• 将外部 API （Open - Meteo）与 MCP 集成

📄 许可证

本项目采用 MIT 协议，© Esa Krissa 。