Url Shortener

🚀 短鏈接縮短工具 MCP 服務器

本項目是一個簡單的 URL 縮短工具，藉助 CleanURI 接口 實現 URL 縮短功能，並可運行在 FastMCP 服務器工具上。

🚀 快速開始

先決條件

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

✨ 主要特性

• 利用 CleanURI API 縮短任意給定的 URL。
• 通過 FastMCP 暴露功能。
• 具備適當的錯誤處理和響應驗證。
• 設計為通過 stdio 傳輸運行，便於與代理或基於工具的系統集成。

項目狀態徽章

項目鏈接