Cleanuri URL Shortener

🚀 短链接缩短工具 MCP 服务器

本项目是一个简单的 URL 缩短工具，借助 CleanURI API 实现 URL 缩短功能，并且专门设计为可运行在 FastMCP 服务器上，为用户提供便捷的短链接服务。

✨ 主要特性

• 利用 CleanURI API，可对任意给定的 URL 进行缩短处理。
• 通过 FastMCP 提供功能接口，方便用户调用。
• 具备适当的错误处理和响应验证机制，保障服务的稳定性。
• 设计为通过 stdio 传输运行，便于与代理或工具系统集成。

🚀 快速开始

🔧 先决条件

• Python 3.10 或更高版本
• httpx
• fastmcp

📦 安装指南

通过 Smithery 自动安装

若要自动在 Smithery 上为 Claude 桌面安装 URL 短链接工具，可执行以下命令：

npx -y @smithery/cli install @Talismanic/cleanuri-url-shortener-mcp --client claude

手动安装

uv add httpx 'mcp[cli]'

Docker 安装

docker build -t url-shortener .

💻 使用示例

运行

uv run main.py

若基于 Docker 使用，无需额外操作。

添加到 Claude 桌面

使用 uv

{
  "mcpServers": {
    "url-shortener": {
      "command": "/Users/{userName}/.local/bin/uv",
      "args": [
        "--directory",
        "{path_to_repo}/cleanuri-url-shortener-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

使用 Docker

{
  "mcpServers": {
    "url-shortener": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--init",
        "-e",
        "DOCKER_CONTAINER=true"
      ]
    }
  }
}