Github

🚀 MCP Financial Agent

A core financial agent for analyzing investment portfolios and generating optimization suggestions.

🚀 Quick Start

This MCP Financial Agent is designed to analyze investment portfolios and provide optimization suggestions. Below are the steps to get started.

✨ Features

• Integration with Tinkoff Invest API
• Portfolio analysis and risk assessment
• Generation of optimization suggestions
• Market data monitoring
• Calculation of profitability indicators

📦 Installation

1. Ensure that Python 3.11 or a higher version is installed.
2. Install Poetry:

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

3. Clone the repository:

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

4. Install dependencies:

poetry install

5. Create a .env file based on .env.example:

cp .env.example .env

6. Configure environment variables.

📚 Documentation

Development Guide

1. Activate the virtual environment:

poetry shell

2. Install pre-commit hooks:

pre-commit install

3. Run tests:

pytest

Usage Examples

Basic Usage

1. Start the agent:

poetry run python -m src.main

2. API access address: http://localhost:8000

Test Guide

# Run all tests and generate a coverage report
pytest

# Run a specific test file
pytest tests/test_specific.py

# Run tests based on tags
pytest -m "not integration"

Project Structure

mcp_finance_agent/
├── src/
│   ├── agent/            # Core module of MCP agent
│   ├── services/         # External service interfaces
│   └── models/          # Data model definitions
├── tests/               # Collection of test cases
└── docs/               # Document repository

📄 License

This project is licensed under the MIT license.