内容
# opn-mcp
[](https://glama.ai/mcp/servers/ysalitrynskyi/opn-mcp)
适用于 **[opn.onl](https://opn.onl)** 的 [MCP](https://modelcontextprotocol.io) 服务器 — 开源、可自行托管的 URL 缩短工具。它允许 AI 助手（Claude Desktop、Cursor 等）缩短链接、读取分析数据、生成二维码并以自然语言管理链接。
适用于托管服务 **或您自己的自行托管实例**。
## 设置
### 1. 获取 API 密钥
在您的 opn.onl 实例中，前往 **设置 → API 密钥**，创建密钥并复制它（以 `opn_` 开头，只显示一次）。
### 2. 将服务器添加到您的 MCP 客户端
**Claude Desktop** — 编辑 `claude_desktop_config.json`（macOS 上为 `~/Library/Application Support/Claude/`，Windows 上为 `%APPDATA%\Claude\`）：
```json
{
"mcpServers": {
"opn": {
"command": "npx",
"args": ["-y", "opn-mcp"],
"env": {
"OPN_API_KEY": "opn_您的密钥_在此"
}
}
}
}
```
重启您的客户端。就这样 — 默认情况下，它与托管 API（`https://l.opn.onl`）通信。
> 尚未发布到 npm？请改用 GitHub 源代码 — 相同的配置，只需更换 `args`：
> `"args": ["-y", "github:ysalitrynskyi/opn-mcp"]`（安装时构建）。
### 自行托管实例
将 `OPN_BASE_URL` 指向您自己的实例的 API 主机：
```json
{
"mcpServers": {
"opn": {
"command": "npx",
"args": ["-y", "opn-mcp"],
"env": {
"OPN_API_KEY": "opn_您的密钥_在此",
"OPN_BASE_URL": "https://l.您的域名.com"
}
}
}
}
```
## 配置
| 环境变量 | 必需 | 默认值 | 描述 |
|---------|----------|---------|-------------|
| `OPN_API_KEY` | ✅ | — | 您的 API 密钥（`opn_…`），来自 设置 → API 密钥 |
| `OPN_BASE_URL` | — | `https://l.opn.onl` | API 基本 URL — 为自行托管实例设置此项 |
## 工具
| 工具 | 描述 |
|------|-------------|
| `shorten_url` | 创建短链接（网址，可选别名/标题/过期时间/密码） |
| `list_links` | 列出您的链接（限制，偏移，搜索） |
| `get_link_stats` | 链接的点击分析数据（地理位置，设备，浏览器，来源） |
| `update_link` | 更新链接的目标网址，标题，过期时间或密码 |
| `delete_link` | 删除链接 |
| `get_qr_code` | 获取链接的二维码 — 可选品牌颜色，中心徽标，PNG/SVG |
| `check_url_health` | 在缩短之前检查目标网址的可访问性 |
## 示例提示
- "缩短 https://example.com/very/long/url 并将其称为 launch-2026"
- "链接 42 收到了多少次点击，来自哪些国家？"
- "给我一个链接 42 的品牌 SVG 二维码"
- "列出我的最后 10 个链接"
## 开发
```bash
npm install
npm run build # tsc → dist/
npm test # vitest
OPN_API_KEY=opn_… npm run dev # 从源代码运行（stdio）
```
## 许可证
MIT © ysalitrynskyi。 [opn.onl](https://github.com/ysalitrynskyi/opn.onl) 项目的一部分。
