URL Shortener MCP Tool

URL 缩短 MCP 工具

本项目使用 CleanURI API 提供简单的 URL 缩短工具，并设计为以 FastMCP 服务工具的形式运行。

✨ 功能

• 使用 CleanURI API 缩短任意给定的 URL。
• 通过 FastMCP 将此功能作为工具提供。
• 包含完善的错误处理和响应验证。
• 设计为通过 stdio 传输运行，以便与 Agent 或基于工具的系统集成。

🚀 用法

1. 要求

• Python 3.10+
• httpx
• fastmcp

2. 安装

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 URL 缩短工具：

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

手动安装

uv add httpx 'mcp[cli]'

Docker 安装：

docker build -t url-shortener .

3. 运行

uv run main.py

使用 Docker 时，无需在此进行任何操作。

4. 在 Claude Desktop 中添加

使用 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",
        "url-shortener"
      ]
    }
  }
}