YOURLS-MCP

一个用于将YOURLS URL缩短服务与Claude Desktop集成的模型控制协议（MCP）服务器。

概述

YOURLS-MCP在Claude Desktop和你自托管的YOURLS URL缩短实例之间创建了一个桥梁。配置完成后，它允许Claude通过你的个人YOURLS安装自动缩短URL。

快速开始

bash

全局安装

npm install -g yourls-mcp

或者直接使用npx运行

npx yourls-mcp@latest

配置Claude Desktop:
json
{
"mcpServers": {
"yourls": {
"command": "npx",
"args": [
"-y",
"yourls-mcp@latest"
],
"env": {
"YOURLS_API_URL": "https://your-yourls-domain.com/yourls-api.php",
"YOURLS_AUTH_METHOD": "signature",
"YOURLS_SIGNATURE_TOKEN": "your-secret-signature-token"
}
}
}
}

功能

• 通过MCP无缝集成到Claude Desktop
• 直接通过Claude缩短URL
• 展开缩短的URL以查看其目标地址
• 获取链接的点击统计信息
• 支持自定义关键词
• 基于安全签名的身份验证
• 环境变量或配置文件支持

配置

你可以通过以下任一方式配置YOURLS-MCP：

1. 环境变量（推荐用于Claude Desktop集成）：

   YOURLS_API_URL=https://your-yourls-domain.com/yourls-api.php
   YOURLS_AUTH_METHOD=signature
   YOURLS_SIGNATURE_TOKEN=your-secret-signature-token

2. 配置文件 (YAML):
   yaml
   yourls:
   api_url: "https://your-yourls-domain.com/yourls-api.php"
   auth_method: "signature"
   signature_token: "your-secret-signature-token"

使用方法

配置完成后，Claude将能够使用如下命令：

• “为我缩短这个URL：https://example.com/long-url”
• “展开这个短URL：https://short.domain/abc”
• “获取这个短URL的统计数据：https://short.domain/abc”

开发

bash

克隆仓库

git clone https://github.com/kesslerio/yourls-mcp.git
cd yourls-mcp

安装依赖

npm install

启动服务器

npm start

许可证

MIT