MCP 金融代理

模型上下文协议代理

用于分析投资组合并生成优化建议的核心金融代理。

功能特点

• 集成 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

使用方法

1. 启动代理：

poetry run python -m src.main

2. API 访问地址：http://localhost:8000

测试指南

# 运行所有测试并生成覆盖率报告
pytest

# 运行特定测试文件
pytest tests/test_specific.py

# 根据标签运行测试
pytest -m "not integration"

项目结构

mcp_finance_agent/
├── src/
│   ├── agent/            # MCP 代理核心模块
│   ├── services/         # 外部服务接口
│   └── models/          # 数据模型定义
├── tests/               # 测试用例集合
└── docs/               # 文档资料库

许可证

MIT