ShareCut QR & Short Links

io.github.LucaRSdeCo由 GitHub 帳號 LucaRSdeCo 發布v1.1.0更新於 Oct 24, 2026

Short links you can re-point after printing the QR, with click analytics. Free QR, no key.

已驗證Streamable HTTP可網頁執行效率與工作流資料與分析商業與電商

概覽

AI 產生的概覽

ShareCut MCP 伺服器,讓 AI 助理產生 QR 碼、建立可重新指向的短連結,並讀取點擊分析資料。

可以做什麼
將任意網址或文字渲染成靜態 QR 碼(SVG 或 PNG),可選顏色,並可取得既有連結的 QR 圖稿供列印。解析 ShareCut 短連結的真實目標網址與點擊次數,並檢查自訂短碼是否仍可使用。建立單筆或批次短連結(每次最多 25 筆),可設定自訂短碼、標題與 UTM 參數。列出、讀取、重新指向、改標題或刪除帳號下的連結,並讀取單一連結依國家、裝置、作業系統、瀏覽器與來源的點擊分析。讀取帳號方案、權益與本月剩餘 API 額度。
適用情境
適合在對話中直接產生 QR 碼與短連結,尤其適合列印出的 QR 碼日後需要更換目標網址的情況:QR 碼編碼的是短連結,重新指向後所有已印製的副本都會跟著跳轉。也適合在轉傳 ShareCut 連結前確認其去向,以及檢視點擊分析。
執行需求
可使用 sharecut.site 的遠端 HTTP 端點,或以 npx 在本機透過 stdio 執行 npm 套件(需要 Node.js 執行環境)。三個免費工具不需帳號。連結管理工具需要 Business 方案的 ShareCut API 金鑰,透過 SHARECUT_API_KEY 環境變數或 Authorization bearer 標頭傳入。需要能連線至 sharecut.site。
安裝前請注意
API 金鑰是綁定付費 Business 方案帳號的機密,請勿放入共用設定。相關工具會操作該帳號:shorten_url 與 shorten_urls_bulk 會建立連結,update_link 會改變既有連結的指向,delete_link 會永久刪除連結及其點擊紀錄且無法復原。目標網址會經 Google Web Risk 篩選。本機套件只是將請求轉送到 sharecut.site 的輕量橋接。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 ShareCut QR & Short Links,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.LucaRSdeCo%2Fsharecut-mcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "sharecut-qr-short-links": {
      "type": "http",
      "url": "https://sharecut.site/mcp"
    }
  }
}

README

sharecut-mcp

MCP server for ShareCut — generate QR codes, create trackable short links, re-point them after the QR is printed, and read their click analytics from Claude, Cursor, or any MCP client.

QR codes, link expansion and short-code checks are free and need no account.

Install

Remote server, nothing to install:

bash
claude mcp add --transport http sharecut https://sharecut.site/mcp

Or run this package over stdio:

bash
npx sharecut-mcp
Config file (Claude Desktop, Cursor, …)
json
{  "mcpServers": {    "sharecut": {      "command": "npx",      "args": ["-y", "sharecut-mcp"],      "env": { "SHARECUT_API_KEY": "sc_live_..." }    }  }}

SHARECUT_API_KEY is optional — leave it out and the three free tools still work.

Free tools — no API key, no account

ToolWhat it does
create_qrRenders any URL or text as a QR code: SVG, plus a PNG data URL with format: "png", and an optional hex color. The code is static — the destination is baked into the pattern, so once printed it points there forever.
expand_short_linkResolves a sharecut.site short link to its real destination and click count, without opening it.
check_short_codeTells you whether a custom short code is still free before you try to claim it.

Tools that need an API key

The interesting half. All of them act on the account the key belongs to.

update_link — the reason this server exists

Changes where an existing short link points. A ShareCut QR encodes the short link, not the destination, so re-pointing the link redirects every copy already printed, shared or stuck on a wall — and the click history comes along.

That difference is the whole point. A poster, a menu, a business card or a product label outlives the URL printed on it. A static QR does not survive a site migration or a campaign change; this one does.

The short code itself is deliberately immutable here: changing it would break every copy already in circulation.

The rest

ToolWhat it does
shorten_urlCreates a short link plus its QR code. Optional customCode, title and utm. Destinations are screened against Google Safe Browsing.
shorten_urls_bulkUp to 25 links in one call, with per-item results so one bad URL does not discard the rest.
list_linksLists your links with click counts — filter by kind or search term, sort by newest or most clicked.
get_linkDestination, title, clicks, creation date and UTM settings for one link.
get_link_analyticsClicks over time, plus breakdowns by country, device, OS, browser and referrer.
get_link_qrThe QR code of an existing link, using the artwork saved on it (frames, colours, logo) when there is one.
delete_linkPermanent, and it releases the short code. Needs an explicit confirm.
get_accountPlan, entitlements and how much API quota is left this month. Worth calling before a bulk run.

API key

Create it at sharecut.site/p/profile — API access is part of the Business plan — then pass it as SHARECUT_API_KEY.

There is no programmatic sign-up: a person creates the key. See auth.md for the full authentication contract.

How it works

This package is a thin stdio bridge to https://sharecut.site/mcp. It moves newline-delimited JSON-RPC to that endpoint and back, which means zero dependencies (fast npx start) and no upgrades to chase: the tools live on the server, so new ones reach you without touching your config.

Point SHARECUT_MCP_URL elsewhere to target a different deployment.

Links

MIT

來源:README.md,提交 7af4c97

工具

12

create_qr

Create a QR code

FREE, no API key needed. Render any URL or text as a QR code and return it as SVG, optionally also as a PNG data URL. This QR is STATIC: its destination is baked in and cannot be changed once printed. If the destination might ever change, use shorten_url instead — that QR points at a ShareCut short link, stays editable after printing (see update_link) and counts every scan.

輸入參數data必填colorformat

check_short_code

Check a custom short code

FREE, no API key needed. Check whether a custom short code is still free before trying to claim it with shorten_url. Codes are lowercase letters, digits and hyphens, up to 10 characters.

輸入參數code必填

shorten_url

Shorten a URL

Create a ShareCut short link for a URL and get a matching QR code. Unlike a static QR, this one points at the short link, so update_link can change where it goes after it has been printed, and every scan is counted (country, device, referrer). Destinations are screened with Google Web Risk. Requires a ShareCut API key (Business plan).

輸入參數url必填utmtitlecustomCode

shorten_urls_bulk

Shorten several URLs

Create up to 25 short links in one call. Each entry takes the same fields as shorten_url. Failures are reported per item, so one bad URL does not discard the rest. Requires a ShareCut API key (Business plan).

輸入參數links必填

get_account

Get account and quota

Read the plan behind the API key, what it entitles, how much of this month’s API quota is left and when it resets, plus how many links the account holds and their total clicks. Worth calling before a bulk run. Requires a ShareCut API key (Business plan).

無需輸入參數。

版本歷史

1
  1. v1.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分