Power your agent
पब्लिशर का इंस्टॉल। PlugMCP एंडपॉइंट नहीं।
Host a copy with our keys and logs.
रजिस्ट्री में अभी कोई पैकेज्ड रिलीज़ नहीं है। रिपॉज़िटरी का README देखें.
रिमोट URL या आपकी मशीन पर कमांड? दोनों इंस्टॉल में क्या अंतर है
PlugMCP पर चलाएँ
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
लॉन्च/my-link); charset isolation prevents collision with generated codesPATCHPOST /api/v1/urls/batch accepts up to 100 URLs; per-item success/failureGET /api/v1/urls/{code}/qr?format=png|jpeg|svg returns a QR code for any short link in three formatstitle and description auto-fetched on create (fail-open, private-IP blocked)none | memory | redis at config time; cache-aside with TTL capped to remaining expirygoshort-cli for shorten, list, stats, delete from the terminalPOST /api/v1/urls/public: no auth, 5 req/min rate limit, 30-day expiry; powers the landing page widget/metrics endpoint, slog throughout, no extra dependencies/docs
Full architecture diagrams: high-level, request flow, layer boundaries.
curl -O https://raw.githubusercontent.com/anIcedAntFA/goshort/main/docker-compose.yml
curl -O https://raw.githubusercontent.com/anIcedAntFA/goshort/main/goshort.toml
docker compose up -d
Caddy handles TLS automatically. Edit goshort.toml to set your base_url and api_key.
curl -L https://github.com/anIcedAntFA/goshort/releases/latest/download/goshort_linux_amd64.tar.gz | tar xz
./goshort
Grab goshort_darwin_arm64, goshort_windows_amd64, etc. from the releases page.
go install github.com/anIcedAntFA/goshort/cmd/server@latest
goshort
Create a short URL:
curl -s -X POST http://localhost:8080/api/v1/urls \
-H "Content-Type: application/json" \
-H "X-API-Key: your-api-key" \
-d '{"url": "https://example.com/very/long/path", "expires_in": "30d"}'
{
"short_code": "k7Xm2p",
"short_url": "http://localhost:8080/k7Xm2p",
"original_url": "https://example.com/very/long/path",
"expires_at": "2025-08-01T00:00:00Z"
}
Redirect:
curl -L http://localhost:8080/k7Xm2p
# → 302 to https://example.com/very/long/path
# Install
go install github.com/anIcedAntFA/goshort/cmd/cli@latest
# Shorten a URL
goshort-cli shorten https://example.com/long --alias my-link --expires 7d
# List all URLs (paginated)
goshort-cli list --page 1 --per-page 20
# Inspect a short code or alias
goshort-cli stats k7Xm2p
# Delete a short URL
goshort-cli delete k7Xm2p
Config file (~/.goshort.toml):
server_url = "http://localhost:8080"
api_key = "your-api-key"
Per-command overrides (precedence: flag > env > config):
GoShort ships an MCP server so AI agents like Claude Code and Cursor can shorten, list, and manage URLs directly.
make build
Create .mcp.json in your project root:
{
"mcpServers": {
"goshort": {
"command": "./bin/goshort",
"args": ["--mcp"],
"env": { "GOSHORT_STORAGE_SQLITE_PATH": "./data/goshort.db" }
}
}
}
The /mcp endpoint is served on the main port alongside the REST API. No separate server needed.
# Connect Claude Code to deployed instance
claude mcp add goshort-remote \
--transport http \
https://goshort.app/mcp \
--header "X-API-Key: your-api-key"
[server]
port = 8080
base_url = "https://short.yourdomain.com"
[auth]
api_key = "your-secret-key" # empty = no auth
[cache]
driver = "none" # none | memory | redis
[shortener]
default_expiry = "0" # "0" = no expiry; or "7d", "30d", "365d"
Every key maps to GOSHORT_<SECTION>_<KEY> env var — e.g., GOSHORT_AUTH_API_KEY=secret. Full reference: goshort.toml.
Auth: X-API-Key: <key> header. Redirect codes: 302 Found, 404 Not Found, 410 Gone (expired).
POST /api/v1/urls body:
Interactive docs at goshort.app/docs. Landing page at goshort.ngockhoi96.dev.
See docs/DESIGN.md for the full architecture, layer boundaries, and design rationale.
git clone https://github.com/anIcedAntFA/goshort
cd goshort
lefthook install # install git hooks (once after clone)
make help # list all targets
Run make help for the full list of targets. See CONTRIBUTING.md for the full development workflow including Redis integration tests and git hooks.
See docs/DEPLOYMENT.md for comprehensive guides.
Docker Compose — GoShort + Caddy (auto-TLS):
docker compose up -d
Fly.io — API + redirects + MCP at goshort.app:
fly launch && fly deploy
Landing page — goshort.ngockhoi96.dev (Cloudflare Workers, static Astro build):
make website/build && cd website && wrangler deploy
Bare VPS — Nginx + systemd + Certbot (see DEPLOYMENT.md)
Each phase ships a working, deployable product.
MIT — see LICENSE.
Self-hosted URL shortener in Go — single binary, SQLite-backed, zero config. Custom aliases, expiration, CLI, Redis cache, MCP server for AI agents (Claude Code, Cursor). Deploy anywhere: Docker, Fly.
ओवरव्यू
Self-hosted URL shortener in Go — single binary, SQLite-backed, zero config. Custom aliases, expiration, CLI, Redis cache, MCP server for AI agents (Claude Code, Cursor). Deploy anywhere: Docker, Fly.io, bare VPS.
टूल
अभी टूल सूची नहीं है। रिमोट सर्वर को पहले हेल्थ चेक के बाद सूची मिलती है।
FAQ
इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए stdio कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
इस रिकॉर्ड में कोई ज़रूरी एनवायरनमेंट वेरिएबल दर्ज नहीं है।
Goshort stdio पर लोकल चलता है।
पिछली जाँच 2026-10-28 को हुई। Self-hosted URL shortener in Go — single binary, SQLite-backed, zero config. Custom aliases, expiration, CLI, Redis cache, MCP server for AI agents (Claude Code, Cursor). Deploy anywhere: Docker, Fly.io, bare VPS.