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"
      ]
    }
  }
}