Bull Vision Agent

Bull Vision Agent

Webhook を使用して Telegram と連携する FastAPI アプリケーションです。OpenAI Agents SDK を活用した AI による株式取引支援を提供し、複数の MCP サーバーの管理には MCPHub を利用します。

機能

• Webhook に対応した Telegram ボット連携
• 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. 複数の MCP サーバーで MCPHub を使用する方法については、create_telegram_chatbot_multi_mcp_server.md を参照してください