Github

🚀 MCP 金融代理

MCP 金融代理是一款核心金融代理工具，主要用於分析投資組合，並能根據分析結果生成優化建議，助力投資者做出更明智的決策。

🚀 快速開始

MCP 金融代理能幫助你進行投資組合分析、風險評估等操作。以下是啟動代理的步驟：

poetry run python -m src.main

API 訪問地址：http://localhost:8000

✨ 主要特性

• 集成 Tinkoff Invest API，方便獲取市場數據。
• 可進行投資組合分析與風險評估，讓你清晰瞭解投資狀況。
• 能生成優化建議，為投資策略調整提供參考。
• 即時監控市場數據，及時掌握市場動態。
• 計算效益性指標，評估投資效益。

📦 安裝指南

1. 確保已安裝 Python 3.11 或更高版本。
2. 安裝 Poetry：

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

3. 克隆倉庫：

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

4. 安裝依賴項：

poetry install

5. 基於 .env.example 創建 .env 文件：

cp .env.example .env

6. 配置環境變量

📚 詳細文檔

開發指南

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 許可證。