🚀 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 许可证。