mcpField
F
finance-portfolio-agent

finance-portfolio-agent

ローカル
github.com/dre1144金融データ082 週間前に更新
リポジトリ

finance-portfolio-agent について

投資家やポートフォリオ管理者向けのPython製MCPエージェントです。Tinkoff Invest APIと連携し、ポートフォリオ分析や市場監視、運用指標の計算を行います。

主な機能

  1. 01Tinkoff Invest API連携
  2. 02ポートフォリオとリスクの分析
  3. 03ポートフォリオ最適化の提案
  4. 04市場データの監視
  5. 05運用パフォーマンス指標の計算

活用シーン

  1. 01ポートフォリオリスクの確認
  2. 02最適化案の検討
  3. 03市場データの監視
  4. 04投資パフォーマンス指標の算出

MCP 対応

MCPエージェントと説明されています。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-agent

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

README（原文）English

プロジェクトの README より

この README の日本語訳はまだありません。以下は英語の原文です。日本語の紹介はページ上部をご覧ください。

MCP Finance Agent

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

Возможности

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

Установка

  1. Убедитесь, что у вас установлен Python 3.11+
  2. Установите Poetry:
curl -sSL https://install.python-poetry.org | python3 -
  1. Клонируйте репозиторий:
git clone <repository-url>
cd mcp-finance-agent
  1. Установите зависимости:
poetry install
  1. Создайте файл .env на основе .env.example:
cp .env.example .env
  1. Настройте переменные окружения в .env

Разработка

  1. Активируйте виртуальное окружение:
poetry shell
  1. Установите pre-commit хуки:
pre-commit install
  1. Запустите тесты:
pytest

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

  1. Запустите агента:
poetry run python -m src.main
  1. 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

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。