Tollbooth Shortlinks

Don't Pester Your Customer™ (DPYC™) — Эфемерные, удобные для человека короткие URL для экосистемы Tollbooth.

Метафоры в этом проекте заимствованы с восхищением из The Phantom Tollbooth Нортона Джастера, с иллюстрациями Жюля Файфера (1961). Milo, Tock, the Tollbooth, Dictionopolis, and Digitopolis — творения необыкновенного воображения мистера Джастера. Мы просто построили платёжную инфраструктуру.

Почему это существует

URL-адреса авторизации OAuth длинные, некрасивые и неудобные для копирования и вставки:

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=...

Традиционные сокращатели ссылок стали своенравными. Они вставляют промежуточные страницы, отслеживают клики, требуют учётные записи, ограничивают функции платными стенами или молча истекают по собственному расписанию. Когда MCP-серверу нужно выдать клиенту одноразовый URL для OAuth-танца, ничего из этого не должно быть на пути.

Tollbooth Shortlinks — это общественная утилита без монетизации. Он превращает любой URL в запоминающуюся фразу из четырёх слов, например brave-otter-finds-gold, сохраняет сопоставление в Neon Postgres и истекает через 24 часа. Сопутствующий обработчик HTTP Val Town выполняет перенаправление 302 без промежуточных страниц.

Related MCP server: mcp-server-hotw

Как это работает

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   |

Инструменты

Все инструменты бесплатны — не требуются кредиты, npub или реестр Tollbooth.

Установка

pip install -e ".[dev]"

Локальный запуск

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

Развёртывание в Horizon

Файл .fastmcp.yaml в корне репозитория готов для fastmcp deploy.

Идентичность DPYC

Tollbooth Shortlinks зарегистрирован как Advocate в Социальном контракте DPYC. Другие MCP-серверы обнаруживают его URL через поиск в реестре:

from tollbooth import resolve_service_by_name

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

Связанные репозитории

Экосистема Tollbooth DPYC™:

Лицензия

Apache-2.0. См. LICENSE для подробностей.