Tollbooth Shortlinks

Don't Pester Your Customer™ (DPYC™) — Flüchtige, benutzerfreundliche Kurz-URLs für das Tollbooth-Ökosystem.

Die Metaphern in diesem Projekt stammen mit Bewunderung aus The Phantom Tollbooth von Norton Juster, illustriert von Jules Feiffer (1961). Milo, Tock, die Tollbooth, Dictionopolis und Digitopolis sind Schöpfungen der außergewöhnlichen Fantasie von Mr. Juster. Wir haben nur die Zahlungsinfrastruktur gebaut.

Warum es das gibt

OAuth-Autorisierungs-URLs sind lang, hässlich und für Copy-and-Paste ungeeignet:

https://api.schwab.com/v1/oauth/authorize?client_id=abc123&redirect_uri=https%3A%2F%2F
fastmcp.cloud%2Foauth%2Fcallback%3Fserver_id%3D...&scope=...&response_type=code&state=...

Herkömmliche Link-Shortener sind eigenwillig geworden. Sie fügen Zwischenseiten ein, verfolgen Klicks, erfordern Konten, sperren Funktionen hinter Paywalls oder lassen Links stillschweigend nach eigenem Zeitplan ablaufen. Wenn ein MCP-Server einem Kunden eine einmalige URL für einen OAuth-Tanz aushändigen muss, gehört nichts davon in den Pfad.

Tollbooth Shortlinks ist ein Community-Dienstprogramm ohne Monetarisierung. Es verwandelt jede URL in eine einprägsame Vier-Wort-Phrase wie brave-otter-finds-gold, speichert die Zuordnung in Neon Postgres und lässt sie nach 24 Stunden ablaufen. Ein begleitender Val-Town-HTTP-Handler führt die 302-Weiterleitung ohne Zwischenseite durch.

Related MCP server: mcp-server-hotw

So funktioniert es

MCP Server                    Shortlinks MCP              Val Town
    |                              |                         |
    |-- create_shortlink(url) ---->|                         |
    |<-- brave-otter-finds-gold ---|                         |
    |                              |                         |
    |  (patron clicks short URL)   |                         |
    |                              |    GET /brave-otter-..  |
    |                              |<------------------------|
    |                              |    Neon lookup           |
    |                              |-- 302 redirect -------->|
    |                              |                         |
    |        (24h later)           |                         |
    |                              |  link expires silently   |

Werkzeuge

Alle Werkzeuge sind kostenlos – keine Credits, kein npub, kein Tollbooth-Ledger erforderlich.

Installation

pip install -e ".[dev]"

Lokal ausführen

export NEON_SHORTLINKS_URL="postgres://user:pass@ep-xyz.us-east-2.aws.neon.tech/shortlinks"
python -c "from server import mcp; mcp.run()"

In Horizon bereitstellen

Die .fastmcp.yaml im Repository-Stammverzeichnis ist bereit für fastmcp deploy.

DPYC-Identität

Tollbooth Shortlinks ist als Advocate im DPYC-Sozialvertrag registriert. Peer-MCP-Server entdecken seine URL über die Registry-Suche:

from tollbooth import resolve_service_by_name

shortlinks_url = resolve_service_by_name("tollbooth-shortlinks")
redirect_base  = resolve_service_by_name("tollbooth-shortlinks-redirect")

Verwandte Repos

Das Tollbooth-DPYC™-Ökosystem:

Lizenz

Apache-2.0. Siehe LICENSE für Details.