myfund-mcp-server

Python MCP License API Platform

myFund.pl MCP Server

Spis treści

Serwer MCP (Model Context Protocol) udostępniający dane portfela inwestycyjnego z myFund.pl jako narzędzia dla Claude Desktop i Claude Code.

Narzędzia

Narzędzie Co zwraca
get_portfolio Podsumowanie portfela: wartość, zysk, stopy zwrotu za okresy (1T / 1M / 3M / 1R / 5R…)
get_positions Lista pozycji posortowana wg wartości (ticker, typ, sektor, konto, zysk)
get_allocation Alokacja wg typu aktywów i wg walorów z kolorami
get_portfolio_timeseries Szereg czasowy: wartość / zysk / wkład / benchmark / stopa zwrotu
show_dashboard Zbiorczy widok wszystkich portfeli naraz

Przykłady użycia

Po podpięciu serwera możesz zadawać Claude pytania w naturalnym języku:

Podsumowanie i wyniki:

„Pokaż podsumowanie portfela Inwestycje” „Jaki jest mój całkowity zysk i stopa zwrotu od początku roku?” „Jak zmieniała się wartość portfela przez ostatnie 12 miesięcy?”

Pozycje i selekcja:

„Które 5 pozycji przyniosło największy zysk?” „Pokaż wszystkie pozycje na koncie IKE” „Jakie ETF-y mam w portfelu i ile każdy z nich waży?”

Alokacja:

„Jak wygląda podział portfela wg typu aktywów?” „Które walory mają największy udział w portfelu?” „Czy jestem zdywersyfikowany sektorowo?”

Analiza w czasie:

„Porównaj stopę zwrotu portfela z benchmarkiem WIG w tym roku” „Kiedy portfel osiągnął najwyższą wartość?” „Pokaż dzienny zysk/stratę za ostatni miesiąc”

Wymagania

Instalacja

1. Sklonuj repozytorium

git clone https://github.com/rafalr100/myfund-mcp-server.git
cd myfund-mcp-server

2. Zainstaluj Pythona 3.12 (jeśli nie masz)

macOS:

brew install python@3.12

Windows: pobierz instalator z python.org.

3. Utwórz środowisko wirtualne i zainstaluj zależności

macOS / Linux:

python3.12 -m venv .venv
source .venv/bin/activate
pip install -e .

Windows:

python -m venv .venv
.venv\Scripts\activate
pip install -e .

4. Pobierz klucz API z myFund.pl

Zaloguj się → Menu → Konto → Ustawienia konta → Klucz API → wygeneruj i skopiuj.

⚠️ Wygenerowanie nowego klucza natychmiast unieważnia poprzedni.

5. Utwórz plik .env

cp .env.example .env

Otwórz .env i wpisz klucz API oraz nazwy swoich portfeli:

MYFUND_API_KEY=twoj_klucz_api
MYFUND_PORTFELE=Nazwa portfela 1,Nazwa portfela 2,Nazwa portfela 3

Nazwy portfeli muszą być dokładnie takie jak na koncie myFund (wielkość liter, spacje). Ta zmienna jest potrzebna tylko do show_dashboard — pozostałe narzędzia działają bez niej.

6. Skonfiguruj Claude

Claude Code — utwórz .mcp.json w katalogu projektu (lub skopiuj z .mcp.json.example):

{
  "mcpServers": {
    "myfund": {
      "command": "/ścieżka/do/myfund-mcp-server/.venv/bin/python",
      "args": ["/ścieżka/do/myfund-mcp-server/src/server.py"]
    }
  }
}

Claude Desktop — otwórz Settings → Developer → Edit Config i dodaj do sekcji "mcpServers":

{
  "mcpServers": {
    "myfund": {
      "command": "/Users/TWOJA_NAZWA/myfund-mcp-server/.venv/bin/python",
      "args": ["/Users/TWOJA_NAZWA/myfund-mcp-server/src/server.py"],
      "env": {
        "MYFUND_API_KEY": "TWOJ_KLUCZ_API",
        "MYFUND_PORTFELE": "Nazwa portfela 1,Nazwa portfela 2,Nazwa portfela 3"
      }
    }
  }
}

Lokalizacja pliku konfiguracyjnego Claude Desktop:

Podmień TWOJA_NAZWA na nazwę użytkownika systemowego (na macOS: wynik whoami w Terminalu).

Ważne: command musi wskazywać na Pythona z .venv — tego, do którego zainstalowano zależności.

7. Zrestartuj Claude Desktop

Cmd+Q (macOS) lub całkowite zamknięcie, potem uruchom ponownie.

8. Test

W nowym czacie napisz:

Pokaż podsumowanie portfela „Nazwa Twojego Portfela”

Dashboard portfeli

Serwer udostępnia narzędzie show_dashboard, które pobiera wszystkie Twoje portfele naraz (z listy MYFUND_PORTFELE) i zwraca dane gotowe do wizualizacji. Po jego wywołaniu Claude buduje interaktywny dashboard jako artefakt HTML, otwierany obok rozmowy.

Wystarczy poprosić:

Pokaż mój dashboard portfeli

Dashboard pokazuje:

Liczba portfeli jest dowolna — zależy od tego, ile nazw wpiszesz w MYFUND_PORTFELE. Stopa zwrotu w widoku zbiorczym to średnia ważona wartością portfeli (nie zwykła średnia procentów).

Uwaga: dashboard powstaje jako artefakt (renderowany przez Claude), nie jako osadzony panel MCP — działa to niezależnie od wersji Claude Desktop.

Skill analityczny (opcjonalnie)

Repozytorium zawiera Agent Skill — skills/myfund-portfolio-analysis/ — dla użytkowników Claude Code. To osobna warstwa, która uczy Claude jak analizować dane z portfela: które z narzędzi wybrać do danego pytania, jak interpretować stopy zwrotu, jak traktować brakujące wartości i gdzie są granice (analiza tak, porady inwestycyjne nie).

Serwer MCP dostarcza dane — skill mówi, jak o nich myśleć.

Co daje skill

Skill jest instalowany automatycznie gdy uruchamiasz Claude Code z katalogu myfund-mcp-server/.

Uwaga: skill wymaga działającego serwera MCP myfund. Sam skill bez serwera nie ma skąd pobrać danych.

Rozwiązywanie problemów

❌ No module named 'mcp'

Przyczyna: Claude uruchamia Pythona systemowego zamiast tego z .venv. Rozwiązanie: Upewnij się, że command w configu wskazuje na .venv/bin/python wewnątrz sklonowanego repozytorium, a nie na systemowy python3.

❌ Odpowiedź nie jest poprawnym JSON-em

Przyczyna: Niepoprawny klucz API lub brak dostępu do bety myFund.pl. Rozwiązanie: Sprawdź klucz w Menu → Konto → Ustawienia konta → Klucz API. Jeśli klucz jest świeży a błąd pozostaje — API myFund.pl jest w fazie beta i dostęp może być ograniczony do wybranych kont.

❌ Portfel nie znaleziony (status 7)

Przyczyna: Nazwa portfela nie zgadza się dokładnie z nazwą na koncie. Rozwiązanie: Sprawdź dokładną nazwę portfela na myFund.pl (wielkość liter, spacje). Nazwa musi być identyczna co do znaku.

❌ Narzędzia nie pojawiają się w Claude Desktop

Przyczyna: Błąd przy starcie serwera lub niepoprawna składnia JSON w configu. Rozwiązanie: Wejdź w Settings → Developer — tam widoczny jest status każdego serwera i log błędów. Najczęściej: literówka w ścieżce lub brakujący przecinek w JSON.

❌ Dane są nieaktualne

Przyczyna: API myFund.pl cache’uje odpowiedzi przez 5 minut. Rozwiązanie: Odczekaj 5 minut od ostatniej zmiany w portfelu i zapytaj ponownie.

Zmienne środowiskowe

Zmienna Wymagana Opis
MYFUND_API_KEY ✅ tak Klucz API z ustawień konta myFund.pl
MYFUND_BASE_URL ❌ nie Nadpisuje base URL (domyślnie https://myfund.pl/API/v1)
MYFUND_PORTFELE ❌ nie Nazwy portfeli do show_dashboard, rozdzielone przecinkami

Uwagi techniczne

Licencja

MIT

🇬🇧 English version

Table of contents

Python MCP License API Platform

An MCP (Model Context Protocol) server that exposes your myFund.pl investment portfolio data as tools for Claude Desktop and Claude Code.

Tools

Tool Returns
get_portfolio Portfolio summary: value, profit, returns for periods (1W / 1M / 3M / 1Y / 5Y…)
get_positions List of holdings sorted by value (ticker, type, sector, account, profit)
get_allocation Allocation by asset type and by security, with hex colours
get_portfolio_timeseries Time series: value / profit / contribution / benchmark / return
show_dashboard Combined view across all portfolios at once

Usage examples

Once connected, you can ask Claude questions in plain language:

Summary & performance:

“Show me a summary of my Investments portfolio” “What is my total profit and year-to-date return?” “How has my portfolio value changed over the last 12 months?”

Holdings & selection:

“Which 5 positions have generated the most profit?” “Show all positions held in my IKE account” “What ETFs do I hold and what is each one’s weight in the portfolio?”

Allocation:

“How is my portfolio split by asset type?” “Which securities have the largest share of the portfolio?” “Am I well diversified across sectors?”

Time series analysis:

“Compare my portfolio return against the WIG benchmark this year” “When did my portfolio reach its peak value?” “Show daily profit/loss for the last month”

Requirements

Installation

1. Clone the repository

git clone https://github.com/rafalr100/myfund-mcp-server.git
cd myfund-mcp-server

2. Install Python 3.12 (if you don’t have it)

macOS:

brew install python@3.12

Windows: download the installer from python.org.

3. Create a virtual environment and install dependencies

macOS / Linux:

python3.12 -m venv .venv
source .venv/bin/activate
pip install -e .

Windows:

python -m venv .venv
.venv\Scripts\activate
pip install -e .

4. Get your API key from myFund.pl

Log in → Menu → Account → Account Settings → API Key → generate and copy.

⚠️ Generating a new key immediately invalidates the previous one.

5. Create a .env file

cp .env.example .env

Open .env and fill in your API key and portfolio names:

MYFUND_API_KEY=your_api_key
MYFUND_PORTFELE=Portfolio name 1,Portfolio name 2,Portfolio name 3

Portfolio names must match exactly as shown in your myFund account (case-sensitive, watch for spaces). This variable is only needed for show_dashboard — all other tools work without it.

6. Configure Claude

Claude Code — create .mcp.json in the project directory (or copy from .mcp.json.example):

{
  "mcpServers": {
    "myfund": {
      "command": "/path/to/myfund-mcp-server/.venv/bin/python",
      "args": ["/path/to/myfund-mcp-server/src/server.py"]
    }
  }
}

Claude Desktop — open Settings → Developer → Edit Config and add to "mcpServers":

{
  "mcpServers": {
    "myfund": {
      "command": "/Users/YOUR_USERNAME/myfund-mcp-server/.venv/bin/python",
      "args": ["/Users/YOUR_USERNAME/myfund-mcp-server/src/server.py"],
      "env": {
        "MYFUND_API_KEY": "YOUR_API_KEY",
        "MYFUND_PORTFELE": "Portfolio name 1,Portfolio name 2,Portfolio name 3"
      }
    }
  }
}

Config file location:

Replace YOUR_USERNAME with your system username (on macOS: run whoami in Terminal).

Important: command must point to the Python binary inside .venv — the one where dependencies were installed.

7. Restart Claude Desktop

Cmd+Q (macOS) or fully close the app, then relaunch.

8. Test

In a new chat, type:

Show me a summary of my portfolio “Your Portfolio Name”

Portfolio dashboard

The server exposes a show_dashboard tool that fetches all your portfolios at once (from the MYFUND_PORTFELE list) and returns visualization-ready data. Claude then builds an interactive HTML dashboard as an artifact, opened beside the conversation.

Just ask:

Show me my portfolio dashboard

The dashboard shows:

The number of portfolios is arbitrary — it depends on how many names you put in MYFUND_PORTFELE. The aggregate return is weighted by portfolio value (not a plain average of percentages).

Note: the dashboard is rendered as an artifact (built by Claude), not an embedded MCP panel — this works regardless of your Claude Desktop version.

Analysis skill (optional)

The repository includes an Agent Skill — skills/myfund-portfolio-analysis/ — for Claude Code users. It is a separate layer that teaches Claude how to analyze portfolio data: which tool to pick for a given question, how to interpret returns, how to treat missing values, and where the boundaries are (analysis yes, investment advice no).

The MCP server provides the data — the skill tells Claude how to think about it.

What the skill adds

The skill is loaded automatically when you start Claude Code from the myfund-mcp-server/ directory.

Note: the skill requires a working myfund MCP server. Without the server, the skill has no data source.

Troubleshooting

❌ No module named 'mcp'

Cause: Claude is launching the system Python instead of the venv one. Fix: Make sure command in the config points to .venv/bin/python inside the cloned repository, not the system python3.

❌ Response is not valid JSON

Cause: Invalid API key or no access to the myFund.pl beta. Fix: Check your key at Menu → Account → Account Settings → API Key. If the key is fresh and the error persists, the myFund.pl API is in beta and access may be restricted to selected accounts.

❌ Portfolio not found (status 7)

Cause: Portfolio name doesn’t exactly match the name on your account. Fix: Check the exact portfolio name on myFund.pl (case-sensitive, watch for trailing spaces). The name must match character for character.

❌ Tools don’t appear in Claude Desktop

Cause: Server failed to start, or invalid JSON syntax in the config file. Fix: Go to Settings → Developer — each server’s status and error log is shown there. Most common causes: typo in a file path, or a missing comma in the JSON.

❌ Data appears stale

Cause: myFund.pl API caches responses for 5 minutes. Fix: Wait 5 minutes after making changes to your portfolio, then ask again.

Environment variables

Variable Required Description
MYFUND_API_KEY ✅ yes API key from myFund.pl account settings
MYFUND_BASE_URL ❌ no Overrides base URL (default: https://myfund.pl/API/v1)
MYFUND_PORTFELE ❌ no Comma-separated portfolio names for show_dashboard

Technical notes

License

MIT

This site is open source. Improve this page.