Skip to main content
Glama
lonniev

tollbooth-shortlinks

by lonniev

Tollbooth Shortlinks

License Version Python

Don't Pester Your Customer™(DPYC™)— Tollbooth エコシステム向けの一時的で人間に優しい短縮 URL。

このプロジェクトのメタファーは、Norton Juster 作、Jules Feiffer 挿絵(1961年)の『The Phantom Tollbooth』から敬意を込めて引用しています。Milo、Tock、Tollbooth、Dictionopolis、Digitopolis は、Juster 氏の並外れた想像力の産物です。私たちはただ決済インフラを構築しただけです。


なぜこれが必要か

OAuth 認可 URL は長く、見苦しく、コピー&ペーストに不向きです:

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 サーバーが OAuth フローのために利用者に一度きりの URL を渡す必要があるとき、そういったものは経路に含まれるべきではありません。

Tollbooth Shortlinks は、収益化のないコミュニティユーティリティです。任意の URL を brave-otter-finds-gold のような覚えやすい4語のフレーズに変換し、マッピングを Neon Postgres に保存し、24時間後に失効させます。付属の Val Town HTTP ハンドラーが中間ページなしで 302 リダイレクトを行います。

Related MCP server: url-shortener-mcp

仕組み

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   |

ツール

ツール

説明

create_shortlink

URL を保存し、覚えやすいスラッグを取得(または独自のものを指定)

resolve_shortlink

リダイレクトせずにスラッグの宛先を調べる

delete_shortlink

失効前にショートリンクを削除する

shortlink_status

アクティブなリンク数と TTL を表示するヘルスチェック

すべてのツールは無料です — クレジット不要、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 は 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™ エコシステム:

リポジトリ

役割

tollbooth-dpyc

車輪 — オペレーター側クレジット台帳、BTCPay クライアント、ツールゲーティング、制約エンジン

tollbooth-authority

機関 — 料金徴収、Schnorr 署名、購入認証

dpyc-oracle

オラクル — ソーシャルコントラクトのガバナンス、メンバーシップ、禁止選挙

dpyc-community

レジストリ — ガバナンスデータ、オペレーターカタログ、コミュニティルール

tollbooth-sample

参照オペレーター — Tollbooth 完全配線の天気 API

cypher-mcp

収益化されたグラフ回答 — Neo4j/AuraDB 上の名前付き Cypher

schwab-mcp

Charles Schwab 証券 MCP — 取引、相場、ポートフォリオアクセス

excalibur-mcp

eXcalibur — X(Twitter)への整形済み投稿

thebrain-mcp

Personal Brain MCP — 思考グラフ、ナレッジ管理

taxsort-mcp

税務仕分け・分類 MCP

optionality-mcp

オプション分析 MCP

tollbooth-shortlinks(このリポジトリ)

コミュニティユーティリティ — OAuth フロー用の一時的短縮 URL

tollbooth-oauth2-collector

OAuth2 コールバックコレクター — ブラウザベースのトークン交換

tollbooth-pricing-studio

iOS アプリ — オペレーターダッシュボードと価格モデルエディター

ライセンス

Apache-2.0。詳細は LICENSE を参照してください。

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables creation of short links, dynamic QR codes, UTM templates, and hosted vCards with click/scan analytics through natural language conversations.
    46 npm
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables creation and management of short links with custom slugs, QR repointing, and cookieless analytics from any MCP client.
    9 npm
    MIT