Bull Vision Agent

Bull Vision Agent

一个 FastAPI 应用，通过 webhook 将 Telegram 与 OpenAI Agents SDK 集成，为股票交易提供 AI 辅助，并利用 MCPHub 管理多个 MCP 服务。

功能

• 集成 Telegram 机器人并支持 webhook
• 使用 OpenAI Agents SDK 进行 AI 股票分析
• 通过 MCPHub 集成多个 MCP 服务：
  • 股票新闻分析
  • 成交量墙检测
• 实时股票数据分析
• 集成市场新闻
• 跟踪对话历史
• 管理交易上下文
• 集成 MongoDB 以持久化数据

项目结构

├── app/
│   ├── __init__.py
│   ├── main.py           # FastAPI app with MCPHub initialization
│   ├── api/
│   │   ├── __init__.py
│   │   └── telegram_webhook.py  # Telegram webhook endpoint
│   ├── bot/
│   │   ├── __init__.py
│   │   ├── bot.py            # Bot instance and context management
│   │   ├── agent.py          # AI agent implementation with MCP servers
│   │   ├── context.py        # Conversation context and history
│   │   └── telegram_handler.py  # Process incoming messages
│   ├── core/
│   │   ├── __init__.py
│   │   └── settings.py   # Application settings
│   ├── models/
│   │   ├── __init__.py
│   │   └── news.py           # News data models
│   ├── services/
│   │   ├── __init__.py
│   │   └── mongodb_service.py # MongoDB operations
│   └── startup.py        # Startup events

设置

1. 克隆代码仓库

2. 安装依赖：

   poetry install
   

3. 将 .env.example 复制为 .env，并填写必需的值：

   cp .env.example .env
   

4. 使用实际值编辑 .env：

   • TELEGRAM_BOT_TOKEN：从 @BotFather 获取的 Telegram 机器人令牌
   • TELEGRAM_WEBHOOK_URL：机器人接收更新的公开 URL
   • HOST 和 PORT：服务配置
   • AZURE_OPENAI_API_KEY：Azure OpenAI API 密钥
   • AZURE_OPENAI_ENDPOINT：Azure OpenAI 端点
   • AZURE_OPENAI_DEPLOYMENT：Azure OpenAI 部署名称
   • AZURE_OPENAI_API_VERSION：Azure OpenAI API 版本
   • MONGO_URI：MongoDB 连接字符串
   • MONGO_DB：MongoDB 数据库名称

运行应用

启动服务：

make run

Webhook 设置

1. 确保你的服务可通过公网访问
2. Webhook URL 格式应为：https://your-domain.com/api/telegram/webhook
3. 应用启动时会自动注册 webhook

可用命令

• /start - 启动机器人
• /help - 显示帮助信息

示例查询

你可以向机器人询问：

• 股票分析（例如：“分析 AAPL”）
• 市场新闻（例如：“Tesla 的最新消息是什么？”）
• 交易策略（例如：“你如何看待当前市场？”）
• 成交量分析（例如：“检查 MSFT 的成交量模式”）

开发命令

make install    # Install dependencies
make run       # Run the application
make test      # Run tests
make lint      # Run linters
make format    # Format the code
make clean     # Clean up generated files
make setup     # Setup development environment
make check     # Run all checks

文档

详细说明请参阅：

1. 设置 Telegram 和 OpenAI Agents SDK 的 AI 聊天机器人，请参阅 init_telegram_openai_agent.md
2. 使用 MCPHub 管理多个 MCP 服务，请参阅 create_telegram_chatbot_multi_mcp_server.md