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 助手生成二维码、创建并可改指向的短链接,以及读取点击分析数据。

可以做什么
把任意网址或文本渲染为静态二维码(SVG 或 PNG),可选颜色,并可获取已有链接的二维码图稿用于打印。解析 ShareCut 短链接的真实目标地址与点击次数,并检查自定义短码是否仍可用。创建单条或批量短链接(每次最多 25 条),可设置自定义短码、标题和 UTM 参数。列出、读取、改指向、改标题或删除账户下的链接,并读取单条链接按国家、设备、操作系统、浏览器和来源的点击分析。读取账户套餐、权益和本月剩余 API 配额。
适用场景
适合在对话中直接生成二维码和短链接,尤其适合打印出的二维码日后需要更换目标地址的场景:二维码编码的是短链接,改指向后所有已印发的副本都会随之跳转。也适合在转发 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 分