MiniURL

io.github.addychang由 GitHub 账号 addychang 发布v1.2.0更新于 Oct 24, 2026

OAuth 2.1 short-link tools for AI agents with scoped tokens, approvals, audit logs, and revocation.

已验证Streamable HTTP可网页运行效率与工作流

概览

AI 生成的概览

MiniURL 为助手提供 OAuth 2.1 短链接工具,支持范围令牌、审批、审计日志和撤销。

可以做什么
MiniURL 是一个远程 MCP 端点,向 AI 代理提供短链接管理能力。按其描述,它使用 OAuth 2.1,具备范围令牌、审批要求、审计日志和撤销功能。清单中未列出具体工具,因此这里无法说明确切的可用操作。
适用场景
当助手需要代表用户创建或管理短链接,并且你希望有范围化访问、审批步骤和审计记录时,可以考虑使用。若只需要只读网页访问或没有短链接工作流,则用处不大。
运行要求
需要支持 streamable HTTP 的远程 MCP 客户端,连接到提供方托管的端点。清单声明无需认证、环境变量、请求头或软件包,但描述提到 OAuth 2.1,因此预计会有 OAuth 授权流程。
安装前请注意
描述提到范围令牌、审批、审计日志和撤销,意味着该服务器可以创建或更改短链接并记录活动。使用前请确认授予的范围和审批内容,并了解哪些链接和账户数据会发送给提供方。

安装

在 SourceWeft 中

  1. 打开 控制台中的 MiniURL,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.addychang%2Fminiurl/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "miniurl": {
      "type": "http",
      "url": "https://workers.miniurl.com/mcp"
    }
  }
}

README

该仓库没有 README。

工具

23

create_guest_token

MiniURL create_guest_token

Create a short-lived MiniURL guest bearer token. Legacy MCP sessions retain it; stateless clients must pass the returned gt_ token explicitly on later requests. shorten_url can provision one automatically.

无需输入参数。

clear_authentication

MiniURL clear_authentication

Clear authentication retained by a legacy MCP session. Stateless clients clear authentication by omitting the Authorization header on later requests.

无需输入参数。

shorten_url

MiniURL shorten_url

Create a MiniURL short link for a supplied HTTP or HTTPS destination. Use when the user asks to shorten a URL or generate a MiniURL link. This is an additive external write; do not fetch or open the destination. If no authentication is supplied, MiniURL automatically starts a guest flow. Reuse idempotency_key when retrying the same logical request.

输入参数url必填aliasdomaindry_runpasswordexpirationactivated_atidempotency_key

send_registration_code

MiniURL send_registration_code

Send a 6-digit registration code to the user email, using the current guest session.

输入参数email必填

verify_registration_code

MiniURL verify_registration_code

Verify the emailed code, create the account, claim guest links, and continue with OAuth 2.1 + PKCE. Long-lived API keys are never returned over MCP.

输入参数code必填email必填

get_account_status

MiniURL get_account_status

Inspect the current guest/free/pro account status, remaining quota, and feature availability.

无需输入参数。

start_pro_upgrade

MiniURL start_pro_upgrade

Create a shortened checkout link for upgrading the current registered account to Pro.

输入参数intervalapproval_idapproval_tokenidempotency_key

list_domains

MiniURL list_domains

List the account’s domains, including miniurl.com, active custom domains and pending setups with their ids and DNS records.

无需输入参数。

add_domain

MiniURL add_domain

Request a custom domain to be connected to MiniURL. Agent domain changes require human approval by default.

输入参数domain必填approval_idapproval_token

delete_domain

MiniURL delete_domain

Delete a custom domain and its linked URLs after a dry-run confirmation. Agent domain changes require human approval by default.

输入参数confirmdomain_id必填approval_idapproval_token

verify_domain

MiniURL verify_domain

Refresh custom-domain DNS and SSL verification status. Agent domain changes require human approval by default.

输入参数domain_id必填approval_idapproval_tokenmigrate_to_server

check_alias

MiniURL check_alias

Check whether a custom alias is available on a given domain before creating a link.

输入参数alias必填domain

list_tags

MiniURL list_tags

List all tags for the current registered account. Tags help organise links into campaigns or categories.

无需输入参数。

create_tag

MiniURL create_tag

Create a new tag for organising links. Maximum 20 tags per account.

输入参数name必填color

delete_tag

MiniURL delete_tag

Delete a tag and remove it from all associated links.

输入参数tag_id必填approval_idapproval_token

版本历史

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

评分

已满足适用检查项的 75%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分

    请声明包含 README 的 GitHub 仓库,或在 OAuth 受保护资源元数据中提供 resource_documentation。

  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。