Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt Anmelden

Finagent — Financial Reports

von finuchetaiVersion 0.7.0rc2i★ 0iLäuft auf deinem ComputerRepository ↗
Name in der Registryio.github.finuchetai/finagent-mcp

So installierst du es

Was es kann

Read-only profit, cash-flow and balance reports. Demo included; client sources need local setup.

Originaltext des Herstellers

  • Verbindung Läuft auf deinem Computer
  • Konto oder Schlüssel Kein Schlüssel nötig
  • Kategorie Buchhaltung, Finanzen & Steuern

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit0/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch0/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert12/100

Qualität: 3/3 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte Finagent — Financial Reports. Folge https://mcp.popnx.com/i/finuchetai-finagent-mcp.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

3/3 Prüfungen bestanden · Läuft auf deinem Computer · ✓ Befehle geprüft am 14. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude, aber erst etwas vorbereiten

Installiere zuerst Python (uv) auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

Von der KI installieren lassen

Kopiere diese Nachricht in einen Claude-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server Finagent — Financial Reports für Claude auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe uv mit uv --version. Fehlt es, sag mir, dass ich es von https://docs.astral.sh/uv/getting-started/installation/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "finagent": { "command": "uvx", "args": [ "open-finance-mcp" ] } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Finagent — Financial Reports wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. uv installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    uv --version
    • Eine Versionsnummer wie uv … = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: uv hat keinen Klick-Installer. Kopiere den Einzeiler für dein System (macOS oder Windows) von der offiziellen uv-Seite ins Terminal · Python muss nicht extra installiert werden, uv lädt es bei Bedarf selbst

    Download-Seite von uv öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: uv --version

    Einmal installieren, gilt für alles, was uv braucht

  2. Einstellungsdatei der Claude-Desktop-App öffnen

    SettingsDeveloperEdit Config

  3. Diese Einstellungen einfügen und speichern

    {
      "mcpServers": {
        "finagent": {
          "command": "uvx",
          "args": [
            "open-finance-mcp"
          ]
        }
      }
    }
  4. Claude beenden und neu öffnen

  5. Ausprobieren

    Nutze Finagent — Financial Reports und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es Finagent — Financial Reports nutzt, oder ein Werkzeug von Finagent — Financial Reports in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann Finagent — Financial Reports noch nicht verbinden

Finagent — Financial Reports läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen

Das kannst du stattdessen tun

A · Eine App nutzen, die Finagent — Financial Reports verbinden kann

  • Installiere zuerst Python (uv) auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
  • Installiere zuerst Python (uv) auf deinem Computer (nur einmal)
  • Installiere zuerst Python (uv) auf deinem Computer (nur einmal)
  • Installiere zuerst Python (uv) auf deinem Computer (nur einmal)

B · Andere in Buchhaltung, Finanzen & Steuern, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Klappt mit Claude Code, aber erst etwas vorbereiten

Installiere zuerst Python (uv) auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen Claude Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server Finagent — Financial Reports für Claude Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe uv mit uv --version. Fehlt es, sag mir, dass ich es von https://docs.astral.sh/uv/getting-started/installation/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): claude mcp add --scope user finagent -- uvx open-finance-mcp 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Finagent — Financial Reports wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. uv installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    uv --version
    • Eine Versionsnummer wie uv … = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: uv hat keinen Klick-Installer. Kopiere den Einzeiler für dein System (macOS oder Windows) von der offiziellen uv-Seite ins Terminal · Python muss nicht extra installiert werden, uv lädt es bei Bedarf selbst

    Download-Seite von uv öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: uv --version

    Einmal installieren, gilt für alles, was uv braucht

  2. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  3. Diesen Befehl einfügen und Enter drücken

    claude mcp add --scope user finagent -- uvx open-finance-mcp
  4. /mcp in Claude Code eingeben

    Finagent — Financial Reports sollte in der Liste als verbunden erscheinen

  5. Ausprobieren

    Nutze Finagent — Financial Reports und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es Finagent — Financial Reports nutzt, oder ein Werkzeug von Finagent — Financial Reports in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor, aber erst etwas vorbereiten

Installiere zuerst Python (uv) auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen Cursor-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server Finagent — Financial Reports für Cursor auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe uv mit uv --version. Fehlt es, sag mir, dass ich es von https://docs.astral.sh/uv/getting-started/installation/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "finagent": { "command": "uvx", "args": [ "open-finance-mcp" ] } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Finagent — Financial Reports wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. uv installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    uv --version
    • Eine Versionsnummer wie uv … = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: uv hat keinen Klick-Installer. Kopiere den Einzeiler für dein System (macOS oder Windows) von der offiziellen uv-Seite ins Terminal · Python muss nicht extra installiert werden, uv lädt es bei Bedarf selbst

    Download-Seite von uv öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: uv --version

    Einmal installieren, gilt für alles, was uv braucht

  2. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  3. KI-Chat in Cursor im Agent-Modus öffnen

  4. Ausprobieren

    Nutze Finagent — Financial Reports und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es Finagent — Financial Reports nutzt, oder ein Werkzeug von Finagent — Financial Reports in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code, aber erst etwas vorbereiten

Installiere zuerst Python (uv) auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen VS Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server Finagent — Financial Reports für VS Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe uv mit uv --version. Fehlt es, sag mir, dass ich es von https://docs.astral.sh/uv/getting-started/installation/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "servers": { "finagent": { "type": "stdio", "command": "uvx", "args": [ "open-finance-mcp" ] } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Finagent — Financial Reports wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. uv installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    uv --version
    • Eine Versionsnummer wie uv … = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: uv hat keinen Klick-Installer. Kopiere den Einzeiler für dein System (macOS oder Windows) von der offiziellen uv-Seite ins Terminal · Python muss nicht extra installiert werden, uv lädt es bei Bedarf selbst

    Download-Seite von uv öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: uv --version

    Einmal installieren, gilt für alles, was uv braucht

  2. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  3. KI-Chat in VS Code im Agent-Modus öffnen

  4. Ausprobieren

    Nutze Finagent — Financial Reports und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es Finagent — Financial Reports nutzt, oder ein Werkzeug von Finagent — Financial Reports in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Finagent — Financial Reports nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user finagent -- uvx open-finance-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "finagent": {
      "command": "uvx",
      "args": [
        "open-finance-mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "finagent": {
      "command": "uvx",
      "args": [
        "open-finance-mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "finagent": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "open-finance-mcp"
      ]
    }
  }
}

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
Nicht auf npm/PyPI
Verbindung
Läuft auf deinem Computer
Neueste Versioni
0.7.0rc2
In der Registry veröffentlichti
14. Nov. 2026
Code zuletzt geänderti
14. Nov. 2026
Entwickler
finuchetai
Pakete
pypi: open-finance-mcp
Website
github.com
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Laufen auf deinem Computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 20. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto finuchetai bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 6 Tagen

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt MIT

  • – Nicht zutreffend

    Endpunkt antwortet

    Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Veröffentlichte Schwachstellen (OSV.dev)

Keine Einträge auf OSV.dev für open-finance-mcp@0.7.0rc2

Prüft nur diese Paketversion, nicht alle Abhängigkeiten · geprüft 16. Nov. 2026

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/finuchetai-finagent-mcp.svg)](https://mcp.popnx.com/en/servers/finuchetai-finagent-mcp)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Buchhaltung, Finanzen & Steuerni

  • Mehr Sterne als 0 % der anderen 3496 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 83 % der anderen 3496 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 3496 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Finagent — Financial Reports sicher?

Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 6 Tagen geändert, und die neueste Version (0.7.0rc2) kam vor 6 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Python (uv) auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: SolidInvoice, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP, Twelve Data

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

von SolidInvoiceWachsend★ 990Aktualisiert vor 11 Tagen

Läuft in der Cloud✓ vom Dienst · solidinvoice.co

Journalit

Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.

von CursivezWachsend★ 261Aktualisiert vor 12 Tagen

Läuft in der Cloud✓ vom Dienst · journalit.co

Beancount.io

Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.

von bex-coWachsend★ 707 Sterne des ganzen ReposAktualisiert letzten Monat

Läuft in der Cloud✓ vom Dienst · beancount.io

Twelve Data

Real-time and historical market data: stocks, forex, crypto, ETFs, fundamentals and 60+ indicators.

von twelvedataWachsend★ 87Aktualisiert vor 16 Tagen

Läuft in der Cloud✓ vom Dienst · twelvedata.com
Im Vergleich mit ähnlichen
Dieser
Finagent — Financial Reports
SolidInvoiceJournalitBeancount.ioTapetide - Indian Stock Market MCPTwelve Data
Läuft woWird auf deinem Rechner installiertLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine Installation
Braucht SchlüsselNeinNeinNeinNeinJaNein
Mit + in Claude hinzufügenNeinNeinNeinNeinNeinJa
Basisprüfungen3/34/64/44/45/54/4
LizenzMITMITNOASSERTIONMITMIT–
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

Финагент MCP — финансовые отчёты для AI-ассистента

English · Скачать 0.7.0rc2 · PyPI · Проверки

Посмотреть сервис «Финагент» →

Автономный финансовый MCP от проекта «Финагент»: подключайте подготовленные отчёты к своему локальному AI-ассистенту и задавайте вопросы о прибыли, движении денег и остатках. Для самостоятельного запуска используйте инструкции ниже. Если нужна помощь с подключением данных и управленческим учётом, оставьте заявку на сайте сервиса.

Репозиторий: finagent-mcp. Имя устанавливаемого Python-пакета open-finance-mcp; команды запуска finance_mcp.server сохранены для совместимости с комплектом 0.3.0.

Текущая версия — 0.7.0rc2, предварительный выпуск: демо, адаптеры CSV/XLSX/PostgreSQL и Google Sheets, проверка среды и реестр кодов. Этот каталог целиком переносим: ему не нужны остальной репозиторий, база, домен, ключи или сервисы автора. Источник — вымышленная мастерская «Маяк», два закрытых месяца и один открытый. Даты фиксированы для воспроизводимости.

Что можно подключить

ИсточникЧто нужноЗависит от Google
ДемоУстановить пакет; свои данные не нужныНет
Excel (.xlsx), CSVКарта подготовленных месячных отчётов и сверка с источникомНет
PostgreSQLСогласованные представления, карта данных, роль только на чтение и сверкаНет
Google SheetsOAuth-вход и поддерживаемый формат месячного отчётаДа; проверка доступа ещё рассматривается

Карту и техническую настройку можно поручить своему агенту по AGENTS.md и поэтапной инструкции. Поддержка PostgreSQL не означает поддержку MySQL или Microsoft SQL Server. Примеры вопросов: «Как изменилась выручка?», «Каковы поступления и выплаты за месяц?», «Чем объясняется отличие прибыли от движения денег?» Ответы ограничены доступными отчётами и их методикой. Из одной выписки прибыль не выводится.

Статус Google-подключения

Локальное чтение ДДС через Google Sheets в Codex на Windows проверено у владельца и внешнего тестировщика, включая повторное подключение после перезапуска Codex. 14.11.2026 оформление Google-приложения проверено и опубликовано; заявка на проверку доступа к таблицам находится на рассмотрении Google. Массовый Google-вход пока не объявляется одобренным.

Обычный git clone не включает зарегистрированную OAuth-конфигурацию приложения или готовый Windows-комплект с Start.cmd. Google-подключение требует отдельно полученного комплекта автора либо Desktop-конфигурации через FINANCE_GOOGLE_OAUTH_APP. Демо работает без Google-входа. Настройка и границы поддержки. Политика конфиденциальности.

Установка Google Sheets в Codex на Windows

Готовый комплект finagent-google-codex-0.7.0rc2.zip доступен в предварительном Release. Это отдельный файл: архив source.zip и стандартные Source code архивы GitHub не содержат Start.cmd и настроек Google-приложения автора.

  1. Установите Codex CLI и Python 3.11 или новее. Нужен доступ к интернету.
  2. Скачайте Windows-комплект и полностью распакуйте его в отдельную папку.
  3. Запустите Start.cmd: войдите в Google, укажите ссылку на свою таблицу, выберите отчёт и месяц, подтвердите валюту и денежные единицы.
  4. После успешной настройки перезапустите Codex и откройте новый чат. Попросите: «Прочитай паспорт и доступные месяцы финансового MCP, затем разбери мой отчёт».

Доступ Google ещё на проверке. При отказе или предупреждении о непроверенном приложении остановитесь и передайте автору текст ошибки; обход предупреждения не является шагом установки. Не отправляйте пароли, коды или токены. Старая установка сохраняется отдельно; повторный запуск использует прежний профиль. Таблица только читается. Подробности и ограничения — в инструкции.

Если вы устанавливаете MCP через ассистента

Передайте ему: «Прочитай AGENTS.md и docs/guided-setup.md. Сначала спроси, где я хочу работать: браузер, настольный ChatGPT или другой клиент. Веди меня по одному шагу, объясняй термины и выполняй техническую настройку сам. Не задавай все вопросы о данных одной анкетой. Сначала посмотри разрешённый источник и объясни, что можно подключить».

Поэтапная настройка простыми словами. Неполный ОПиУ, например только до валовой прибыли, поддерживается с явно указанными ограничениями; отсутствие чистой прибыли не требует выдумывать её или дополнять исходник нулями.

Быстрый запуск

Пакет опубликован в PyPI. Для установки без клонирования репозитория:

python3 -m venv .venv

.venv/bin/python -m pip install 'open-finance-mcp[files,postgres]==0.7.0rc2' .venv/bin/python -m finance_mcp.diagnostics stdio --timeout 15

Без конфигурации запускается вымышленное демо. На Windows используйте python и .venv\Scripts\python.exe. Для работы агента с картой источника см. поэтапную настройку. Установка из исходников и запуск тестов:

Нужен Python 3.11+ с venv/pip и доступ к индексу Python-пакетов при первой установке. Скопируйте только этот каталог в отдельное место. Внутри копии:

python3 preflight.py environment

python3 -m venv .venv .venv/bin/python -m pip install . .venv/bin/python -m finance_mcp.diagnostics stdio --timeout 15 .venv/bin/python -m unittest discover -s tests -p test_demo.py -v .venv/bin/open-finance-mcp

Последняя команда ждёт сообщений MCP на stdin; пустой экран — нормально. Завершение: Ctrl+C. Сервер запускается помощником как дочерний процесс; отдельный фоновой сервис и открытый порт ему не нужны. На Windows используйте .venv\Scripts\python.exe.

Подключение к локальному агенту

В настройках MCP клиента, поддерживающего stdio, укажите абсолютный путь к Python созданной venv. Структура конфигурации зависит от клиента; типовой фрагмент:

{

"mcpServers": { "finance-demo": { "command": "/absolute/path/to/demo/.venv/bin/python", "args": ["-m", "finance_mcp.server"] } } }

Рабочая папка клиента может быть любой: код установлен в venv, данных с относительными путями нет. Проверка ниже использует настоящий subprocess из временной рабочей папки. В 0.4.0 добавлен защищённый Streamable HTTP для удалённых клиентов и генератор локального/удалённого плагина. Выбор клиента и самостоятельное размещение. Для браузера потребуются сервер владельца, HTTPS и настроенный OAuth-провайдер; публикация кода сама по себе их не создаёт.

Передайте агенту: «Прочитай AGENTS.md, установи этот пакет в отдельную venv, выполни проверки и помоги добавить stdio MCP в мой локальный клиент. Покажи прибыль и остаток денег за сентябрь 2026 и объясни, почему прибыль отличается от движения денег».

Ожидаемо: прибыль сентября 75000.00 RUB, движение денег 80000.00 RUB, остаток на конец 155000.00 RUB. Это учебные числа; сначала прочитайте паспорт.

Интерфейс адаптера (контракт 1.1)

finance_mcp.contract.FinanceAdapter — Python Protocol без зависимости от MCP SDK:

  • passport() -> str: подтверждённая методика и ограничения одного клиента;
  • periods() -> tuple[Period, ...]: периоды и доступные отчёты;
  • report(kind, month) -> Report: ОПиУ, ДДС или остатки;
  • notes(month) -> str: примечания закрытого периода.

Собственный адаптер передаётся в finance_mcp.server.create_server(adapter). Сервер не знает SQL, таблиц и файлов источника. Без --config CLI запускает DemoAdapter; подключение CSV/XLSX/PostgreSQL выбирается через --config. Контракт не является механизмом авторизации: будущий адаптер обязан обеспечивать права на стороне источника.

Report: тип, период, валюта ISO-кодом, источник, as_of (подтверждённая дата состояния с TZ или null), отдельные received_at / as_of_status / source_time_raw, complete и непустой tuple строк. Строка: устойчивый code, название, разрез, Decimal и статус value/missing/not_applicable. Последние два означают None, в JSON — null, и отличаются от денежного нуля. Пропуск требует complete=false. Уникальность строки — (code, dimension). Итоги имеют собственные коды; правила сложения описывает паспорт, инструмент не складывает строки и не конвертирует валюты. Разные отчёты могут иметь разные валюты, это всегда явно в ответе каждого отчёта.

FinanceService проверяет запрос целиком до загрузки отчётов: 1–12 уникальных периодов, закрытость и доступность отчёта; неверный запрос отклоняется, частичного успешного ответа нет. Проверяется соответствие возвращённого отчёта запросу. Деньги сериализуются строками; ответ — один текстовый JSON без дублирования в structuredContent.

Проверки и границы готовности

Тесты сверяют все 24 строки демо, денежные тождества и разные смыслы нуля/пропуска, подставляют второй адаптер через публичный интерфейс, проверяют отказ на открытый, отсутствующий и испорченный период. Интеграция запускает установленный сервер по stdio, делает initialize/list_tools и вызывает все шесть инструментов, включая отрицательные сценарии и повторный запуск. Никаких подключений к реальным финансовым системам нет.

Перенос: скопируйте preflight.py, README.md, AGENTS.md, pyproject.toml, src/, tests/, docs/ и examples/. Не переносите .venv, build, *.egg-info, кэши или настройки исходного проекта. Удаление установки: остановите MCP в клиенте, уберите его конфигурацию, удалите копию пакета и venv. Секретов и внешних ресурсов это демо не создаёт.

Для публичного выпуска выбрана лицензия MIT; текст — LICENSE. Правообладатель: Самойлова Татьяна. Репозиторий публичный; предварительный выпуск 0.7.0rc2 опубликован. См. порядок выпуска. SDK: официальная документация stdio.

Источники клиента

Установите pip install '.[files,postgres]' внутри venv. Примеры вымышленного клиента «Липа» — examples/lipa: 40 строк, 7 отчётов, две точки. Проверка CSV: python -m finance_mcp.server --config examples/lipa/csv.json --check. В аргументы MCP-клиента добавьте --config и абсолютный путь к JSON. Формат экспорта, Excel, PostgreSQL, права, обновление и полный прогон.

Проверка среды, короткая stdio-проба, даты и постоянные коды. Примеры в examples/lipa: csv-registry.json для реестра и csv-dates.json для неизвестной даты состояния. Шаблон акта сверки фиксирует границы приёмки и согласование владельца; тесты его не подписывают.

Обратная связь и участие

Ошибки описывайте по шаблону, без реальных финансовых данных, персональных сведений и секретов. Инструкция по изменениям: CONTRIBUTING.md. Уязвимости: SECURITY.md. История: CHANGELOG.md.

Самостоятельное использование MCP не требует регистрации в сервисе «Финагент». Ссылка на сервис помогает найти команду проекта и получить помощь с подключением.

Google Sheets (0.5.0)

Прямое чтение одной выбранной книги сервисным аккаунтом владельца и обновление через refresh_source. Оригинал не меняется. Поддерживаются нормализованные диапазоны и согласованная карта широкого отчёта. См. инструкцию. Live-приёмка сервисного аккаунта остаётся отдельным обязательным этапом.

Вход Google без сервисного аккаунта (0.6.0)

Основной путь: агент запускает finance-mcp-google login

Nur der Anfang wird gezeigt; den Rest findest du im Repo