RejestrÚZ MCP Server

Co robi MCP Server „RÚZ Open API”?

RÚZ Open API MCP Server zapewnia publiczny dostęp do danych księgowych zarejestrowanych na Słowacji poprzez portal registeruz.sk, udostępniając je w formacie JSON możliwym do odczytu maszynowego. Został zaprojektowany do łączenia asystentów AI i deweloperów z Rejestrem Sprawozdań Finansowych (Register účtovných závierok), upraszczając dostęp do aktualnych, ustrukturyzowanych danych o podmiotach księgowych, ich sprawozdaniach i powiązanych metadanych. Serwer ten umożliwia programistyczne zapytania o listę podmiotów, pobieranie szczegółowych rekordów, pobieranie szablonów oraz dostęp do oficjalnych list kodów. Udostępniając te zasoby i usługi, RÚZ Open API wspiera przepływy pracy oparte na AI w zakresie zgodności, analizy finansowej, integracji danych i innych, umożliwiając dostęp do danych w czasie rzeczywistym, przyrostowe aktualizacje oraz standaryzowane pobieranie danych finansowych.

Lista zasobów

• Zoznam identifikátorov (Lista identyfikatorów)
  • Udostępnia listę identyfikatorów dla różnych typów danych (np. podmioty księgowe, sprawozdania) do dalszych zapytań o szczegóły.
• Detaily entity (Szczegóły podmiotu)
  • Zwraca szczegółowe atrybuty danego podmiotu na podstawie jego identyfikatora.
• Číselníky (Listy kodów/ Rejestry)
  • Udostępnia oficjalne listy kodów pochodzące ze Słowackiego Urzędu Statystycznego (ŠÚSR) dla spójnych odniesień.
• Šablóny účtovných výkazov (Szablony raportów finansowych)
  • Dostarcza szablony różnych raportów finansowych do standaryzacji przesyłania i analizy danych.

Przykładowe zastosowania tego MCP servera

• Automatyczne pobieranie sprawozdań finansowych
  • Deweloperzy i analitycy mogą programistycznie uzyskiwać aktualne sprawozdania finansowe słowackich firm na potrzeby audytów, due diligence lub analizy ryzyka kredytowego.
• Monitorowanie podmiotów księgowych
  • Umożliwia bieżące lub zaplanowane sprawdzanie aktualizacji/zmian w wybranych podmiotach księgowych, zapewniając szybkie wykrycie nowych zgłoszeń lub korekt.
• Integracja z przepływami zgodności AI
  • Asystenci AI mogą wykorzystywać API do wzbogacania kontroli zgodności lub procesów KYC („Poznaj swojego klienta”) o oficjalne dane finansowe.
• Synchronizacja list kodów
  • Standaryzuje dane referencyjne w różnych systemach poprzez programistyczną aktualizację list kodów używanych w raportowaniu finansowym lub integracji danych.
• Przyrostowe pobieranie danych
  • Wspiera wydajne hurtownie danych lub procesy ETL poprzez umożliwienie pobierania przyrostowego na podstawie daty ostatniej modyfikacji.

Jak skonfigurować

Windsurf

1. Upewnij się, że Node.js i środowisko deweloperskie są skonfigurowane.
2. Zlokalizuj plik konfiguracyjny Windsurf.
3. Dodaj RÚZ Open API MCP Server za pomocą poniższego fragmentu JSON:

   {
     "mcpServers": {
       "ruz-open-api": {
         "command": "npx",
         "args": ["@ruz/mcp-server@latest"]
       }
     }
   }
   

4. Zapisz konfigurację i uruchom ponownie Windsurf.
5. Zweryfikuj połączenie, uzyskując dostęp do endpointa MCP servera.

Claude

1. Skonfiguruj wymagane zależności (np. Node.js).
2. Otwórz plik konfiguracyjny Claude MCP.
3. Wstaw poniższy fragment w sekcji mcpServers:

   {
     "mcpServers": {
       "ruz-open-api": {
         "command": "npx",
         "args": ["@ruz/mcp-server@latest"]
       }
     }
   }
   

4. Zapisz i uruchom ponownie Claude.
5. Potwierdź dostępność MCP servera.

Cursor

1. Przygotuj środowisko deweloperskie wraz z wymaganymi zależnościami.
2. Edytuj plik konfiguracyjny Cursor.
3. Dodaj konfigurację RÚZ Open API MCP server:

   {
     "mcpServers": {
       "ruz-open-api": {
         "command": "npx",
         "args": ["@ruz/mcp-server@latest"]
       }
     }
   }
   

4. Zapisz zmiany i uruchom ponownie Cursor.
5. Przetestuj integrację MCP.

Cline

1. Upewnij się, że wszystkie wymagane składniki (Node.js itd.) są zainstalowane.
2. Znajdź i otwórz plik konfiguracyjny Cline.
3. Dodaj poniższy wpis MCP servera:

   {
     "mcpServers": {
       "ruz-open-api": {
         "command": "npx",
         "args": ["@ruz/mcp-server@latest"]
       }
     }
   }
   

4. Zapisz i uruchom ponownie Cline.
5. Zweryfikuj, czy MCP server działa.

Zabezpieczanie kluczy API

(Nie opisano w dokumentacji; sekcja pozostaje pusta.)

Jak używać tego MCP we flow

Wykorzystanie MCP w FlowHunt

Aby zintegrować MCP server z przepływem w FlowHunt, rozpocznij od dodania komponentu MCP do swojego flow i połączenia go z agentem AI:

Kliknij na komponent MCP, aby otworzyć panel konfiguracji. W sekcji konfiguracji systemu MCP wstaw szczegóły swojego MCP servera w tym formacie JSON:

{
  "ruz-open-api": {
    "transport": "streamable_http",
    "url": "https://www.registeruz.sk/cruz-public/home/api"
  }
}

Po skonfigurowaniu agent AI może korzystać z tego MCP jako narzędzia ze wszystkimi jego funkcjami i możliwościami. Pamiętaj, aby zmienić „ruz-open-api” na faktyczną nazwę swojego MCP servera i podać własny URL MCP.

Przegląd

Nasza opinia:
Ten MCP jest dobrze udokumentowany pod względem zasobów API, ale brakuje mu definicji narzędzi, szablonów promptów oraz szczegółów dotyczących zabezpieczenia kluczy API czy sampling/roots. To solidne źródło danych, ale wymaga dalszego rozwoju MCP po stronie integracji z LLM.

Ocena MCP

RÚZ Open API MCP Score: 4/10
Choć możliwości dostępu do danych są solidne, serwerowi brakuje funkcji MCP takich jak definicje narzędzi, sampling i wsparcie roots oraz nie posiada jasnej licencji ani sygnałów open source. Ogranicza to jego użyteczność w przepływach AI „out-of-the-box”.