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