opn-mcp 是开源、可自托管的短链服务 opn.onl 的 MCP 服务器，用于让 AI 助手（如 Claude Desktop、Cursor 等）以自然语言完成短链相关操作。
用途：在 AI 客户端中缩短链接、读取点击分析、生成二维码、管理链接，可对接 opn.onl 托管服务或用户自托管实例。
主要能力：缩短单个或多个链接并命名、归入文件夹；查询某链接在指定时间段内的点击量与来源国家；生成品牌化 SVG 二维码；为链接打标签、查看仪表盘统计；构建带 UTM 参数的链接。
使用方式：先在 opn.onl 实例的 Settings → API Keys 创建 API 密钥（以 opn_ 开头，仅显示一次）。然后在 MCP 客户端配置服务器，例如 Claude Desktop 编辑 claude_desktop_config.json（macOS 位于 ~/Library/Application Support/Claude/，Windows 位于 %APPDATA%\Claude/），重启客户端即可，默认连接托管 API https://l.opn.onl。也可从源码运行，将 args 换成 GitHub 构建："args": ["-y", "github:ysalitrynskyi/opn-mcp"]。自托管时通过 OPN_BASE_URL 指向自有实例的 API 主机。
适用场景：需要在 AI 对话中批量生成短链、做营销活动链接与 UTM 跟踪、查看链接点击分析或生成二维码的用户。
限制：需自行准备 opn.onl API 密钥；自托管需配置 OPN_BASE_URL；发布相关流程仅面向项目维护者账号，普通用户无需关注。项目采用 MIT 许可。
