VISO TRUST MCP Server
Ein Model Context Protocol (MCP)-Server zur Integration von VISO TRUST API-Funktionen mit KI-Assistenten.
Anforderungen
Java 21+
Gradle
Docker (optional für containerisierte Bereitstellung)
MCP Inspector (optional zum Testen)
Konfiguration
VISO TRUST API-Konfiguration
Für die VISO TRUST API können folgende Eigenschaften konfiguriert werden:
visotrust.api.base-url: Die Basis-URL für die VISO TRUST API (Standard: http://localhost:8080 )visotrust.api.token: Ihr API-Token von der VISO TRUST-Plattform (erforderlich)visotrust.api.timeout: API-Anforderungstimeout in Millisekunden (Standard: 30000)visotrust.api.connect-timeout: API-Verbindungstimeout in Millisekunden (Standard: 5000)
Informationen zum Generieren eines API-Tokens für die Umgebungsvariable visotrust.api.token finden Sie in der VISO TRUST-Supportdokumentation .
Installation
Schnellinstallation
Klicken Sie auf eine der folgenden Schaltflächen, um den VISO MCP-Server in VS Code zu installieren:
Manuelle Einrichtung mit VS Code
Fügen Sie den folgenden JSON-Block zu Ihrer Benutzereinstellungsdatei (JSON) in VS Code hinzu. Drücken Sie dazu Strg + Umschalt + P und geben Sie „Einstellungen: Benutzereinstellungen öffnen (JSON)“ ein.
Optional können Sie ein ähnliches Beispiel (d. h. ohne den MCP-Schlüssel) zu einer Datei namens .vscode/mcp.json in Ihrem Arbeitsbereich hinzufügen. Dadurch können Sie die Konfiguration mit anderen teilen.
Verwendung mit Claude Desktop und anderen MCP-Clients
Docker-Konfiguration
Java-Konfiguration
Hinweis: Mit der Umgebungsvariable JAVA_TOOL_OPTIONS werden die JVM-Optionen für das Remote-Debugging festgelegt. Adresse und Port können bei Bedarf geändert werden.
💻 Entwicklung
Docker-Setup
Docker-Image erstellen
Docker-Container ausführen
Debuggen
MCP Inspector installieren
Führen Sie MCP Inspector zum Testen aus
Erstellen Sie eine MCP-Server-JAR-Datei
Führen Sie MCP Inspector aus
Ersetzen Sie <version> durch die aktuelle Version des Projekts (z. B. 1.0.0 oder die Version der neuesten Veröffentlichung).
CI/CD-Pipeline
Dieses Projekt nutzt GitHub Actions für kontinuierliche Integration und Bereitstellung. Der Workflow umfasst die folgenden Jobs:
Fussel
Überprüft die Codeformatierung mit Spotless:
Bauen
Erstellt die Anwendung und erstellt eine JAR-Datei:
Veröffentlichen
Wenn eine neue Version erstellt wird:
Aktualisiert die Projektversion in build.gradle, damit sie mit dem Release-Tag übereinstimmt
Lädt die JAR-Datei mit der Version aus dem Release-Tag in die GitHub-Version hoch
Erstellt und überträgt das Docker-Image mit den folgenden Tags zum Docker Hub:
latestDer Release-Tag (z. B.
v1.0.0)
Erforderliche Geheimnisse für die Veröffentlichung
Um die Docker Hub-Veröffentlichung zu aktivieren, fügen Sie Ihrem GitHub-Repository diese Geheimnisse hinzu:
DOCKERHUB_USERNAME: Ihr Docker Hub-BenutzernameDOCKERHUB_TOKEN: Ihr Docker Hub-Zugriffstoken
🛠️ Werkzeuge
Dieser Abschnitt enthält die Dokumentation zu den vom VISO MCP-Server bereitgestellten Tools. Jedes Tool hat einen bestimmten Zweck, bestimmte Eingabeparameter und ein bestimmtes Ausgabeformat.
Bewertungen
get_assessment - Holen Sie sich eine Bewertung anhand ihrer ID
id: Bewertungs-ID (Nummer, erforderlich)
Gibt detaillierte Informationen zu einer bestimmten Bewertung zurück.
create_assessment - Eine Bewertung starten
relationshipId: Die ID der Beziehung, für die eine Bewertung erstellt werden soll (Nummer, erforderlich)
recipientEmail: Die E-Mail des Empfängers (Zeichenfolge, erforderlich)
recipientFirstName: Der Vorname des Empfängers (Zeichenfolge, erforderlich)
recipientLastName: Der Nachname des Empfängers (Zeichenfolge, erforderlich)
publicDocumentUrls: URLs öffentlicher Dokumente (string[], optional)
followupType: Die Art der Nachverfolgung (Zeichenfolge, erforderlich)
followupRiskThreshold: Der Risikoschwellenwert für die Nachverfolgung (Zeichenfolge, optional)
aiProcessingOnly: Ob nur die KI-Verarbeitung verwendet werden soll (boolesch, optional)
Dateien: Dateien, die in die Bewertung einbezogen werden sollen (byte[][], optional)
Gibt die erstellten Bewertungsdetails zurück.
Überwachungsprotokolle
get_user_audit_log_events – Rufen Sie die Audit-Log-Ereignisse für Ihre Organisation ab
Anfrage: Parameter für die Audit-Protokollanforderung (Objekt, erforderlich)
startDate: Startdatum für die Audit-Log-Ereignisse (Zeichenfolge, erforderlich)
endDate: Enddatum für die Audit-Log-Ereignisse (Zeichenfolge, erforderlich)
auditLogType: Typ der abzurufenden Audit-Log-Ereignisse (Zeichenfolge, optional)
Gibt eine Liste der Benutzerüberwachungsprotokollereignisse zurück, begrenzt auf 500 Datensätze.
Geschäftsfälle
get_all_business_cases – Holen Sie sich alle verfügbaren Geschäftsfälle für Ihre Organisation
Keine Parameter erforderlich.
Gibt eine Liste aller für Ihre Organisation verfügbaren Geschäftsfälle zurück.
Datentypen
get_all_datatypes - Alle verfügbaren Datentypen für Ihre Organisation abrufen
Keine Parameter erforderlich.
Gibt eine Liste aller für Ihre Organisation verfügbaren Datentypen zurück.
IQR (Intelligente Abfrageantwort)
ask_trust_center – Stellen Sie Fragen zu Ihrem AI Trust Center
Anfrage: Trustcenter-Abfrageparameter (Objekt, erforderlich)
Abfrage: Die zu stellende Frage (Zeichenfolge, erforderlich)
Gibt KI-generierte Antworten auf Fragen zu Ihrem AI Trust Center zurück.
ask_relationship - Stellen Sie Fragen zu einer bestimmten Beziehung
Anfrage: Beziehungsabfrageparameter (Objekt, erforderlich)
relationshipId: Die ID der abzufragenden Beziehung (Nummer, erforderlich)
Abfrage: Die zu stellende Frage (Zeichenfolge, erforderlich)
Gibt KI-generierte Antworten auf Fragen zu einer bestimmten Beziehung zurück.
Beziehungen
get_all_relationships - Ruft eine Liste aller Beziehungen und ihrer Bewertungsdetails ab
Keine Parameter erforderlich.
Gibt Informationen zu Drittanbietern zurück, einschließlich ihres Bewertungsstatus, ihrer Risikostufen und Kontaktdaten.
get_relationship_by_id – Rufen Sie eine bestimmte Beziehung und ihre Bewertungsdetails nach ID ab
id: Beziehungs-ID (Nummer, erforderlich)
Gibt detaillierte Informationen zu einem Drittanbieter zurück, einschließlich Bewertungsstatus, Risikostufen und Kontaktdaten.
create_relationship - Erstellen Sie eine neue Beziehung mit einem Drittanbieter
Anfrage: Parameter zur Beziehungserstellung (Objekt, erforderlich)
vendorName: Name des Anbieters (Zeichenfolge, erforderlich)
businessOwnerEmail: E-Mail des Geschäftsinhabers (Zeichenfolge, erforderlich)
Homepage: URL der Homepage des Anbieters (Zeichenfolge, optional)
businessContextIds: IDs von Geschäftskontexten (number[], optional)
dataTypeIds: IDs der Datentypen (number[], optional)
Tags: Auf die Beziehung anzuwendende Tags (string[], optional)
Gibt die erstellten Beziehungsdetails zurück.
update_relationship – Aktualisieren einer bestehenden Beziehung mit einem Drittanbieter
Anfrage: Beziehungsaktualisierungsparameter (Objekt, erforderlich)
id: Beziehungs-ID (Nummer, erforderlich)
vendorName: Name des Anbieters (Zeichenfolge, optional)
Homepage: URL der Homepage des Anbieters (Zeichenfolge, optional)
businessContextIds: IDs von Geschäftskontexten (number[], optional)
dataTypeIds: IDs der Datentypen (number[], optional)
businessOwnerEmail: E-Mail des Geschäftsinhabers (Zeichenfolge, optional)
Tags: Auf die Beziehung anzuwendende Tags (string[], optional)
Gibt die aktualisierten Beziehungsdetails zurück.
partially_update_relationship - Eine bestehende Beziehung teilweise aktualisieren
Anfrage: Teilweise Beziehungsaktualisierungsparameter (Objekt, erforderlich)
id: Beziehungs-ID (Nummer, erforderlich)
[Alle Felder aus update_relationship, die geändert werden müssen]
Gibt die aktualisierten Beziehungsdetails zurück, wobei nur die angegebenen Felder geändert wurden.
search_relationships - Suche nach Beziehungen nach Domänennamen oder Anbieternamen
Anfrage: Suchparameter (Objekt, erforderlich)
Abfrage: Suchanfrage (Zeichenfolge, erforderlich)
Gibt eine Liste übereinstimmender Beziehungen mit ihren Bewertungsdetails zurück.
create_tags - Neue Tags zum Kategorisieren von Beziehungen erstellen
Anfrage: Parameter zur Tag-Erstellung (Objekt, erforderlich)
Tags: Liste der zu erstellenden Tags (string[], erforderlich)
Gibt eine Liste aller Tags zurück, einschließlich der neu erstellten.
update_third_party_contact – Aktualisieren Sie die Kontaktdaten eines Drittanbieters
Anfrage: Kontakt-Update-Parameter (Objekt, erforderlich)
relationshipId: Beziehungs-ID (Nummer, erforderlich)
E-Mail: Kontakt-E-Mail (Zeichenfolge, erforderlich)
firstName: Vorname des Kontakts (Zeichenfolge, erforderlich)
lastName: Nachname des Kontakts (Zeichenfolge, erforderlich)
Gibt die aktualisierten Beziehungsdetails zurück.
get_suggested_contacts - Erhalten Sie Kontaktvorschläge für eine Beziehung
relationshipId: Beziehungs-ID (Nummer, erforderlich)
Gibt eine Liste potenzieller Kontakte bei der Lieferantenorganisation zurück.
Webhooks
get_all_webhooks – Alle Webhooks abrufen
Keine Parameter erforderlich.
Gibt eine Liste aller Webhook-Konfigurationen zurück.
get_webhook - Ruft eine Webhook-Konfiguration nach ID ab
id: Webhook-ID (Nummer, erforderlich)
Gibt Details einer bestimmten Webhook-Konfiguration zurück.
create_webhook_configuration – Erstellen einer Webhook-Konfiguration
Anfrage: Parameter zur Webhook-Erstellung (Objekt, erforderlich)
url: Webhook-URL (Zeichenfolge, erforderlich)
Geheimnis: Webhook-Geheimnis (Zeichenfolge, erforderlich)
eventTypes: Ereignistypen zum Auslösen des Webhooks (string[], erforderlich)
serviceType: Diensttyp für den Webhook (Zeichenfolge, erforderlich)
Gibt die erstellte Webhook-Konfiguration zurück.
update_webhook_configuration – Aktualisieren einer Webhook-Konfiguration
Anfrage: Webhook-Update-Parameter (Objekt, erforderlich)
id: Webhook-ID (Nummer, erforderlich)
url: Webhook-URL (Zeichenfolge, optional)
Geheimnis: Webhook-Geheimnis (Zeichenfolge, optional)
eventTypes: Ereignistypen zum Auslösen des Webhooks (string[], optional)
serviceType: Diensttyp für den Webhook (Zeichenfolge, optional)
Gibt die aktualisierte Webhook-Konfiguration zurück.
delete_webhook_configuration – Löschen einer Webhook-Konfiguration
id: Webhook-ID (Nummer, erforderlich)
Löscht die angegebene Webhook-Konfiguration.
Codeformatierung
Dieses Projekt verwendet Spotless mit Google Java Format zur Codeformatierung. Ein Pre-Commit-Hook wird automatisch eingerichtet, um einen konsistenten Codestil zu gewährleisten.
Aufstellen
Nach dem Klonen des Repository wird der Pre-Commit-Hook automatisch eingerichtet, wenn Sie einen beliebigen Gradle-Befehl ausführen.
Manuelle Formatierung
So formatieren Sie alle Dateien manuell:
So überprüfen Sie, ob die Dateien richtig formatiert sind:
Wenn der Pre-Commit-Hook Ihren Commit aufgrund von Formatierungsproblemen ablehnt, führen Sie einfach ./gradlew spotlessApply aus, um die Formatierung zu korrigieren, und versuchen Sie dann erneut, den Commit durchzuführen.
Lizenz
Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE .
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Viso-MCP-Server
Related MCP Servers
- Asecurity-licenseAqualityMiro MCP server, exposing all functionalities available in official Miro SDK.Last updated -977450Apache 2.0
- MIT License
- Apache 2.0