MCP-Server

In GREYHOUND ist ein rudimentärer Model Context Protocol Server (MCP-Server) integriert. Über das MCP-Protokoll können sich externe Agenten und Tools mit GREYHOUND verbinden und die vorhandenen Endpunkte aufrufen.

Ein typischer Anwendungsfall ist die Integration von GREYHOUND in Automatisierungs- oder Agenten-Frameworks wie z. B. n8n, Cursor AI oder andere MCP-kompatible Clients.

Der MCP-Server stellt die bestehenden GREYHOUND-RPC-Funktionen strukturiert als MCP-Tools zur Verfügung.

Spezifikationen

Die offizielle MCP-Spezifikation ist hier dokumentiert: https://modelcontextprotocol.io
Jede RPC-Methode des GREYHOUND-Servers wird 1:1 als eigenes MCP-Tool exponiert.
Es erfolgt keine zusätzliche Abstraktions- oder Business-Logik auf MCP-Ebene.

Voraussetzungen

GREYHOUND ab Version 5.7.0
Zugriff auf den GREYHOUND-Server über HTTP oder HTTPS
Gültiger Authentifizierungs-Token (Basic Auth)

Authentifizierung

Für jeden Zugriff auf den MCP-Server ist ein Authorization-Header erforderlich. Format:

Authorization: Basic <token>

Der Token entspricht dem bekannten GREYHOUND-API-Zugriff und unterliegt denselben Rechten und Einschränkungen.

Basis-URL

Der MCP-Server ist unter folgender Basis-URL erreichbar:

https://<ServerUrl>/mcp

Über diese URL können:

alle verfügbaren MCP-Tools geladen werden
Metadaten zu den exponierten RPC-Methoden abgerufen werden

Tool-Struktur und Performance

Standardmäßig werden beim Zugriff auf /mcp sämtliche verfügbaren Tools geladen.

Zur Verbesserung der Performance und zur Reduzierung des Tool-Scopes können Tools klassenspezifisch geladen werden.

Laden einer einzelnen Tool-Klasse

Dazu wird der Klassenname an die Basis-URL angehängt:

https://<ServerUrl>/mcp/<RpcClassName>

Beispiel:

https://<ServerUrl>/mcp/RpcInfoLib

In diesem Beispiel-Fall werden ausschließlich die RPC-Methoden aus RpcInfoLib als MCP-Tools bereitgestellt.

Diese Variante wird insbesondere empfohlen für:

Agenten mit engem Funktionsfokus
Performanzkritische Integrationen
Entwicklungs- und Testumgebungen

Verwendung mit Cursor AI (Beispiel)

Der Editor Cursor AI unterstützt die direkte Einbindung externer MCP-Server.

Konfiguration

In Cursor AI die Settings öffnen.
Tools & MCP auswählen.
New MCP Server anklicken.
Die geöffnete JSON-Konfigurationsdatei anpassen.

Beispielkonfiguration:

{
  "mcpServers": {
    "gh-info": {
      "type": "http",
      "url": "http://<YourServer>/mcp/RpcInfoLib",
      "headers": {
        "Authorization": "Basic <token>"
      }
    },
    "gh-cities": {
      "type": "http",
      "url": "http://<YourServer>/mcp/RpcCitiesLib",
      "headers": {
        "Authorization": "Basic <token>"
      }
    },
    "gh": {
      "type": "http",
      "url": "http://<YourServer>/mcp",
      "headers": {
        "Authorization": "Basic <token>"
      }
    }
  }
}