mcpField
W
Weather Bot with OpenAI Agents SDK

Weather Bot with OpenAI Agents SDK

本地服务
github.com/esakrissa开发工具684 周前更新
代码仓库

关于 Weather Bot with OpenAI Agents SDK

面向希望通过自然语言查询实时天气的用户的 Telegram 天气机器人。它使用 OpenAI Agents SDK 和 GPT-4o-mini，并从 Open-Meteo 获取天气数据。

主要功能

  1. 01用自然语言回答天气查询
  2. 02从 Open-Meteo 获取实时天气
  3. 03提供温度、天气状况和风速
  4. 04采用适合 Telegram 的消息格式

适用场景

  1. 01查询某个城市的当前天气
  2. 02通过 Telegram 查看风速和温度

MCP 相关

项目实现了一个简单的 MCP 服务，提供 `get_weather` 工具，从 Open-Meteo 获取数据供机器人的 Agent 使用。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

使用 OpenAI Agents SDK 的天气机器人

一个使用 OpenAI Agents SDK 和模型上下文协议（MCP）提供实时天气信息的 Telegram 机器人。该机器人由 GPT-4o-mini 模型驱动，可通过自然语言查询获取全球各城市的当前天气状况。

功能

  • 使用 Open-Meteo API 获取实时天气数据
  • 使用 OpenAI Agents SDK（GPT-4o-mini）进行自然语言处理
  • 用于获取天气数据的简单 MCP 服务实现
  • 适配 Telegram 的消息格式
  • 简单易用的界面，可通过简单的天气查询获取信息

技术栈

  • Python 3.11+
  • OpenAI Agents SDK
  • 模型上下文协议（MCP）
  • python-telegram-bot
  • Open-Meteo API（无需 API 密钥）

快速开始

  1. 克隆仓库：
git clone https://github.com/esakrissa/agents-sdk-telegram.git
cd agents-sdk-telegram
  1. 创建并激活虚拟环境：
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
  1. 安装依赖：
pip install -r requirements.txt
  1. 在项目根目录创建一个 .env 文件：
TELEGRAM_BOT_TOKEN=your_bot_token_here
OPENAI_API_KEY=your_openai_api_key_here
  1. 运行机器人：
python main.py

使用方法

只需向机器人发送消息，询问任意城市的天气：

what's the weather in Ubud?

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

  • 温度
  • 天气状况
  • 风速

架构

OpenAI Agents SDK 集成

该机器人使用 OpenAI Agents SDK 和 GPT-4o-mini 模型处理自然语言查询，并生成类人回复。Agent 配置了处理天气相关查询和保持对话上下文的专用指令。

模型上下文协议（MCP）

该项目实现了一个简单的 MCP 服务（weather_mcp.py），提供 get_weather 工具。该示例展示了如何：

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

许可证

MIT © Esa Krissa

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。