finance-portfolio-agent

Name: finance-portfolio-agent
Author: dre1144

本地服务

github.com/dre1144金融数据082 周前更新

代码仓库

关于 finance-portfolio-agent

面向投资者和投资组合管理者的 Python MCP Agent，用于分析投资组合并生成建议。它集成 Tinkoff Invest API，并支持市场监控和绩效指标计算。

主要功能

01集成 Tinkoff Invest API
02投资组合与风险分析
03投资组合优化建议
04监控市场数据
05计算绩效指标

适用场景

01检查投资组合风险
02寻找投资组合优化方案
03监控市场数据
04计算投资绩效指标

MCP 相关

项目自称为 MCP Agent。README 介绍了投资组合分析和建议功能，但未说明向 MCP 客户端提供的工具或资源。

#finance #portfolio-analysis #recommendation-agent

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "finance-portfolio-agent": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SUPABASE_URL",
        "-e",
        "SUPABASE_SERVICE_KEY",
        "-e",
        "ENCRYPTION_KEY",
        "-e",
        "MCP_API_KEY",
        "-e",
        "MCP_API_URL",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "mcp/finance-portfolio-agent"
      ],
      "env": {
        "SUPABASE_URL": "<SUPABASE_URL>",
        "SUPABASE_SERVICE_KEY": "<SUPABASE_SERVICE_KEY>",
        "ENCRYPTION_KEY": "<ENCRYPTION_KEY>",
        "MCP_API_KEY": "<MCP_API_KEY>",
        "MCP_API_URL": "<MCP_API_URL>",
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<GITHUB_PERSONAL_ACCESS_TOKEN>"
      }
    }
  }
}

启动命令

docker run -i --rm -e SUPABASE_URL -e SUPABASE_SERVICE_KEY -e ENCRYPTION_KEY -e MCP_API_KEY -e MCP_API_URL -e GITHUB_PERSONAL_ACCESS_TOKEN mcp/finance-portfolio-agent

需要配置的环境变量

SUPABASE_URL

SUPABASE_SERVICE_KEY密钥

ENCRYPTION_KEY密钥

MCP_API_KEY密钥

MCP_API_URL

GITHUB_PERSONAL_ACCESS_TOKEN密钥

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

ocimcp/finance-portfolio-agentstdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

README 原文English

来自项目 README

README 暂无中文译文，以下为英文原文；中文介绍见上方。

MCP Finance Agent

Model Context Protocol агент для анализа финансового портфеля и генерации рекомендаций.

Возможности

Интеграция с Tinkoff Invest API
Анализ портфеля и рисков
Генерация рекомендаций по оптимизации портфеля
Мониторинг рыночных данных
Расчет метрик эффективности

Установка

Убедитесь, что у вас установлен Python 3.11+
Установите Poetry:

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

Клонируйте репозиторий:

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

Установите зависимости:

poetry install

Создайте файл .env на основе .env.example:

cp .env.example .env

Настройте переменные окружения в .env

Разработка

Активируйте виртуальное окружение:

poetry shell

Установите pre-commit хуки:

pre-commit install

Запустите тесты:

pytest

Использование

Запустите агента:

poetry run python -m src.main

API будет доступно по адресу: http://localhost:8000

Тестирование

# Запуск всех тестов с отчетом о покрытии
pytest

# Запуск конкретного теста
pytest tests/test_specific.py

# Запуск тестов с метками
pytest -m "not integration"

Структура проекта

mcp_finance_agent/
├── src/
│   ├── agent/            # Ядро MCP агента
│   ├── services/         # Внешние сервисы
│   └── models/          # Модели данных
├── tests/               # Тесты
└── docs/               # Документация