Github

🚀 MCP 金融代理

このプロジェクトは、投資ポートフォリオを分析し、最適化提案を生成するための核心的な金融エージェントです。

🚀 クイックスタート

MCP 金融エージェントを使用することで、投資ポートフォリオの分析や最適化提案の生成が可能です。以下に、基本的な使用手順を示します。

✨ 主な機能

• Tinkoff Invest API を統合
• 投資ポートフォリオの分析とリスク評価
• 最適化提案の生成
• 市場データの監視
• 収益性指標の計算

📦 インストール

前提条件

• Python 3.11 以上がインストールされていることを確認してください。

インストール手順

1. Poetry をインストールします。

curl -sSL https://install.python-poetry.org | python3 -

2. リポジトリをクローンします。

git clone <repository-url>
cd mcp-finance-agent

3. 依存関係をインストールします。

poetry install

4. .env.example をもとに .env ファイルを作成します。

cp .env.example .env

5. 環境変数を設定します。

💻 使用例

基本的な使用法

1. エージェントを起動します。

poetry run python -m src.main

2. API のアクセスアドレスは、http://localhost:8000 です。

高度な使用法

開発手順

1. 仮想環境を有効化します。

poetry shell

2. プリコミットフックをインストールします。

pre-commit install

3. テストを実行します。

pytest

テスト手順

# すべてのテストを実行し、カバレッジレポートを生成します
pytest

# 特定のテストファイルを実行します
pytest tests/test_specific.py

# ラベルに基づいてテストを実行します
pytest -m "not integration"

📚 ドキュメント

プロジェクト構造

mcp_finance_agent/
├── src/
│   ├── agent/            # MCP エージェントの核心モジュール
│   ├── services/         # 外部サービスのインターフェース
│   └── models/          # データモデルの定義
├── tests/               # テストケースの集合
└── docs/               # ドキュメントの資料庫

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。