Zum Hauptinhalt springen
MCP (Model Context Protocol) ist ein von Anthropic entwickeltes Modellkontextprotokoll, das es KI-Modellen (wie Claude, GPT usw.) ermöglicht, externe Tools über eine standardisierte Schnittstelle aufzurufen. Mit dem von AceData Cloud bereitgestellten ShortURL MCP Server können Sie in AI-Clients wie Claude Desktop, VS Code, Cursor direkt Kurzlinks generieren.

Funktionsübersicht

Der ShortURL MCP Server bietet folgende Kernfunktionen:
  • Einzelne URL verkürzen — Lange URLs in kurze, leicht teilbare Kurzlinks umwandeln
  • Batch-URL-Verkürzung — Mehrere URLs auf einmal verkürzen (bis zu 10)
  • Benutzerhandbuch — Vollständige Gebrauchsanweisung und Best Practices erhalten
  • API-Informationen — API-Dienstdetails und Fehlercodes einsehen

Voraussetzungen

Vor der Nutzung benötigen Sie ein AceData Cloud API Token:
  1. Registrieren oder anmelden auf der AceData Cloud Plattform
  2. Zur ShortURL API Seite wechseln
  3. Auf „Acquire“ klicken, um das API Token zu erhalten (bei der ersten Beantragung gibt es ein kostenloses Kontingent)

Installation und Konfiguration

Methode 1: Installation via pip (empfohlen)

pip install mcp-shorturl

Methode 2: Installation aus dem Quellcode

git clone https://github.com/AceDataCloud/MCPShortURL.git
cd MCPShortURL
pip install -e .
Nach der Installation können Sie den Dienst mit dem Befehl mcp-shorturl starten.

Verwendung in Claude Desktop

Bearbeiten Sie die Konfigurationsdatei von Claude Desktop:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Fügen Sie folgende Konfiguration hinzu:
{
  "mcpServers": {
    "shorturl": {
      "command": "mcp-shorturl",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "Ihr API Token"
      }
    }
  }
}
Wenn Sie uvx verwenden möchten (kein vorheriges Installieren von Paketen nötig):
{
  "mcpServers": {
    "shorturl": {
      "command": "uvx",
      "args": ["mcp-shorturl"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "Ihr API Token"
      }
    }
  }
}
Speichern Sie die Konfiguration und starten Sie Claude Desktop neu, um die ShortURL-Tools im Chat verwenden zu können.

Verwendung in VS Code / Cursor

Erstellen Sie im Projektstammverzeichnis die Datei .vscode/mcp.json:
{
  "servers": {
    "shorturl": {
      "command": "mcp-shorturl",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "Ihr API Token"
      }
    }
  }
}
Oder verwenden Sie uvx:
{
  "servers": {
    "shorturl": {
      "command": "uvx",
      "args": ["mcp-shorturl"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "Ihr API Token"
      }
    }
  }
}

Verfügbare Tools

ToolnameBeschreibung
shorturl_createEinzelne URL verkürzen
shorturl_batch_createMehrere URLs gleichzeitig verkürzen (max. 10)
shorturl_get_usage_guideVollständige Gebrauchsanleitung abrufen
shorturl_get_api_infoAPI-Dienstdetails abrufen

Anwendungsbeispiele

Nach der Konfiguration können Sie diese Funktionen direkt in Ihrem AI-Client per natürlicher Sprache aufrufen, zum Beispiel:
  • „Bitte kürze diesen Link für mich“
  • „Verkürze diese 5 URLs in einem Batch“
  • „Erstelle einen Kurzlink zum Teilen“

Weitere Informationen