@kimagure-dd/xirr-mcp

MCP-Server für die Berechnung des XIRR (Extended Internal Rate of Return) mit integrierter Unterstützung für Transaktions-CSVs von Rakuten Securities (楽天証券).

Binden Sie ihn in Claude Desktop oder Claude Code ein, übergeben Sie eine von Ihrem Broker exportierte CSV-Datei und fragen Sie:

„Berechne die jährliche Rendite basierend auf dieser CSV und dem aktuellen Bewertungswert von ¥1.500.000“

Claude berechnet den XIRR für Sie – unter Berücksichtigung unregelmäßiger Ein- und Auszahlungen – und erläutert das Ergebnis.

Funktionen

• 🧮 calculate_xirr — XIRR aus beliebigen Cashflow-Reihen + aktueller Bewertung

• 📄 parse_rakuten_csv — Analysiert Rakuten Securities Transaktions-CSVs (取引履歴) in normalisierte Cashflows

• 🔌 Reiner stdio MCP-Server, kein Netzwerkzugriff erforderlich

• 📦 Keine Laufzeitkonfiguration, einzelner npx-Befehl

Installation & Einrichtung

Claude Desktop

Bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "xirr": {
      "command": "npx",
      "args": ["-y", "@kimagure-dd/xirr-mcp"]
    }
  }
}

Starten Sie Claude Desktop neu. Die Tools calculate_xirr und parse_rakuten_csv sollten nun erscheinen.

Claude Code

claude mcp add xirr -- npx -y @kimagure-dd/xirr-mcp

Anwendungsbeispiele

Direkte Berechnung

Fragen Sie Claude:

„Berechne den XIRR für folgende Cashflows: 1.000.000 Yen Investition am 01.01.2020, 500.000 Yen zusätzlich am 01.01.2022, aktueller Wert (01.01.2025) 2.000.000 Yen“

Claude ruft calculate_xirr mit strukturierter Eingabe auf und gibt Folgendes zurück:

{
  "annualRate": 12.34,
  "annualRateFormatted": "12.34%",
  "totalInvestment": 1500000,
  "totalGain": 500000,
  "gainRateFormatted": "33.33%",
  "converged": true
}

Aus Rakuten Securities CSV

1. Bei Rakuten Securities einloggen → Transaktionsverlauf (取引履歴) → CSV herunterladen

2. (Da der Download in Shift_JIS erfolgt, bitte in UTF-8 konvertieren)

3. Übergeben Sie den Dateiinhalt an Claude mit der Bitte: „Berechne damit die jährliche Rendite. Der aktuelle Wert beträgt ¥X“

Claude leitet die CSV automatisch durch parse_rakuten_csv → calculate_xirr weiter.

Tool-Referenz

calculate_xirr

Berechnet den XIRR aus einer Liste datierter Cashflows und einem aktuellen Bewertungswert.

Eingabe:

Ausgabe:

parse_rakuten_csv

Analysiert eine Rakuten Securities Transaktions-CSV.

Eingabe:

Erforderliche CSV-Header:

約定日, 取引, ファンド名, 受渡金額/(ポイント利用)[円]

Verhalten:

• 買付 Zeilen → positiver Betrag (Investition)

• Andere Transaktionstypen (z. B. 売却) → negativer Betrag (Auszahlung)

• Ungültige Zeilen werden mit Warnungen übersprungen

Berechnungsmethode

• Newton-Raphson-Iteration als primärer Löser

• Bisektions-Fallback, wenn Newton nicht konvergiert

• Zeiteinheit: Monate (unter Verwendung von 365,25 / 12 Tagen pro Monat)

• Konvergenzschwelle: 1e-7

Die gleiche Logik wird im browserbasierten XIRR-Rechner auf kimagure-dd.dev verwendet, daher sind die Ergebnisse identisch.

Haftungsausschluss

Dieses Tool berechnet die Anlageperformance nur zu Informationszwecken. Steuern, Transaktionsgebühren und Währungsumrechnungen werden nicht berücksichtigt. Die Ausgabe stellt keine Anlageberatung dar.

Entwicklung

npm install
npm run build
npm test

Um den Server lokal vor der Veröffentlichung zu testen:

npm pack
# Then point Claude Desktop to the .tgz path

Lizenz

MIT © kimagure-dd

Verwandtes

• 🌐 kimagure-dd.dev — Browserbasierte Finanzrechner

• 📊 XIRR-Rechner (Webversion)

• 🐙 Quellcode