Hosten Ihres eigenen MCP-Servers

Hosten Sie benutzerdefinierte oder Drittanbieter-MCP-Server als Databricks-Apps. Benutzerdefinierte MCP-Server sind nützlich, wenn Sie bereits über einen MCP-Server verfügen, den Sie bereitstellen möchten, oder wenn Sie einen MCP-Server eines Drittanbieters als Quelle von Tools ausführen möchten.

Der Zugriff auf benutzerdefinierte MCP-Server wird über Databricks-Apps-Berechtigungen gesteuert. Um benutzerdefinierte MCP-Aktivitäten zusammen mit Ihren anderen MCP-Servern und LLM-Endpunkten zu überwachen, verwenden Sie Unity AI Gateway.

Informationen zum Verwenden eines gehosteten benutzerdefinierten MCP-Servers im Agentcode finden Sie unter Verwenden von MCP-Servern in Agents.

Anforderungen

  • Ein MCP-Server, der als Databricks-App gehostet wird, muss einen HTTP-kompatiblen Transport implementieren, z. B. den streambaren HTTP-Transport.

Erstellen oder Bereitstellen eines benutzerdefinierten MCP-Servers

Wählen Sie die Option aus, die Ihrem Ausgangspunkt entspricht:

File new icon. Mit einer Vorlage beginnen: einen neuen MCP-Server aus der integrierten „Hallo Welt“-Vorlage erstellen

Erstellen eines benutzerdefinierten MCP-Servers aus der Vorlage "Apps"

Verwenden Sie die integrierte Hallo Welt MCP Server-Vorlage, um einen MCP-Server mit beispielbasierten Tools zu erstellen und bereitzustellen:

  1. Klicken Sie auf der Seitenleiste auf Compute.

  2. Klicken Sie auf die Registerkarte "Apps ".

  3. Klicken Sie auf "App erstellen".

  4. Wählen Sie unter der Kategorie Agents die Vorlage MCP Server - Hallo Welt aus.

  5. Geben Sie einen App-Namen ein, der beginnt mcp- (z. B mcp-hello-world. ).

    Note

    Der App-Name muss beginnen, mcp- damit er als MCP-Server im AI-Playground erkannt wird.

  6. Klicken Sie auf "App erstellen".

Azure Databricks stellt die App mit Beispielcode bereit, den Sie anpassen können.

Die Vorlage enthält zwei Beispieltools für die ersten Schritte:

  • health(): Ein Diagnosetool, das bestätigt, dass der Server betriebsbereit ist und Statusinformationen zurückgibt.
  • get_current_user(): Ein Tool, das die Informationen des aktuellen Benutzers mithilfe des Databricks SDK abruft und veranschaulicht, wie die Arbeitsbereichsauthentifizierung integriert wird.

Hinzufügen eines benutzerdefinierten Tools

Um Ein eigenes Tool hinzuzufügen, öffnen Sie den Quellcode der App, und definieren Sie eine neue Funktion mithilfe des @mcp.tool() Dekorators. Mit dem folgenden Tool wird beispielsweise eine Zeichenfolge in Großbuchstaben konvertiert:

@mcp.tool()
def uppercase(text: str) -> str:
    """Convert a string to uppercase."""
    return text.upper()

Jedes Tool muss eine Docstring enthalten. KI-Agents verwenden die Docstring, um zu verstehen, wann das Tool aufgerufen werden soll. Nachdem Sie ein Tool hinzugefügt haben, stellen Sie die App erneut bereit, um sie verfügbar zu machen.

Weitere Informationen zum Arbeiten mit App-Vorlagen finden Sie unter Erstellen einer App aus einer Vorlage oder im Quellcode der Vorlage auf GitHub.

Symbol Bereitstellen eines vorhandenen Servers: Hosten eines MCP-Servers, den Sie bereits als Databricks-App haben

Hosten eines vorhandenen MCP-Servers als Databricks-App

Führen Sie die folgenden Schritte aus, um einen vorhandenen Python MCP-Server als Databricks-App zu hosten:

Richten Sie Ihre Umgebung ein

Bevor Sie Ihren MCP-Server bereitstellen, authentifizieren Sie sich mit OAuth für Ihren Arbeitsbereich.

  1. Führen Sie Folgendes in einem lokalen Terminal aus:

    databricks auth login --host https://<your-workspace-hostname>

Einrichten des MCP-Servers

Verwenden Sie uv für die Abhängigkeitsverwaltung und einheitliche Tools bei der Bereitstellung Ihres MCP-Servers.

  1. Fügen Sie ein requirements.txt zum Stammverzeichnis des MCP-Servers hinzu und fügen Sie uv als Abhängigkeit hinzu.

    uv behandelt die Installation zusätzlicher Abhängigkeiten, die in Der Projektkonfiguration definiert sind.

    uv

  2. Erstellen Sie eine pyproject.toml Datei, die einen Skripteinstiegspunkt für Ihren Server definiert.

    Beispiel pyproject.toml:

    [project.scripts]
custom-server = "server.main:main"

    In diesem Beispiel:

    • custom-server ist der Skriptname, den Sie mit uv run
    • server.main:main Gibt den auszuführenden Modulpfad (server/main.py) und die Funktion (main) an.

  3. Fügen Sie eine app.yaml Datei hinzu, die den CLI-Befehl angibt, mit dem der MCP-Server unter Verwendung von uv run ausgeführt wird.

    Standardmäßig lauschen Databricks-Apps auf Port 8000. Wenn der Server auf einen anderen Port lauscht, setzen Sie ihn mithilfe einer Umgebungsvariablenüberschreibung in der app.yaml Datei fest.

    Beispiel app.yaml:

    command: [
    'uv',
    'run',
    'custom-server', # This must match a script defined in pyproject.toml
  ]

Wenn Sie ausführen uv run custom-server, sucht uv nach der Skriptdefinition, sucht den Modulpfad und ruft die main() Funktion auf.

Bereitstellen des MCP-Servers als Databricks-App

  1. Erstellen Sie eine Databricks-App zum Hosten des MCP-Servers:

    databricks apps create mcp-my-server

    Note

    Stellen Sie Ihrem App-Namen mcp- ein Präfix voran, um ihn eindeutig als MCP-Server zu identifizieren. Diese Benennungskonvention hilft bei der Auffindbarkeit und Organisation in Ihrem Arbeitsbereich.

  2. Laden Sie den Quellcode in Azure Databricks hoch, und stellen Sie die App bereit, indem Sie die folgenden Befehle aus dem Verzeichnis ausführen, das Ihre app.yaml Datei enthält:

    DATABRICKS_USERNAME=$(databricks current-user me | jq -r .userName)
databricks sync . "/Users/$DATABRICKS_USERNAME/mcp-my-server"
databricks apps deploy mcp-my-server --source-code-path "/Workspace/Users/$DATABRICKS_USERNAME/mcp-my-server"

Finden Sie die bereitgestellte App-URL

Nach der Bereitstellung finden Sie Ihre App-URL in der Azure Databricks UI. Der MCP-Serverendpunkt ist unter https://<app-url>/mcp.

Weitere Ressourcen

  • Last updated on