URL Shortener MCP Tool

URL Shortener MCP Tool

site icon
2025.03.25 1
PythonURL 缩短工具开发效率
cleanuri-url-shortener-mcp 是一个基于 CleanURI API 的 URL 缩短工具,设计为 FastMCP 服务器工具运行。它能够将任何给定的 URL 缩短,并通过 FastMCP 将功能作为工具暴露出来。该工具包含适当的错误处理和响应验证,设计为通过 `stdio` 传输运行,以便与代理或基于工具的系统集成。
View on GitHub

Overview

✨ 核心功能

  • 使用 CleanURI API 缩短任何给定的 URL。
  • 通过 FastMCP 将功能作为工具暴露。
  • 包含适当的错误处理和响应验证。
  • 设计为通过 stdio 传输运行,以便与代理或基于工具的系统集成。

🚀 使用场景

  • 需要快速缩短 URL 的场景。
  • 集成到代理或基于工具的系统中的 URL 缩短需求。

🛠️ 工具列表

  • CleanURI API:用于 URL 缩短的核心 API。
  • FastMCP:用于将功能作为工具暴露的框架。

❓ 常见问题解答

无明确常见问题解答部分。

📦 使用依赖

  • Python 3.10+
  • httpx
  • fastmcp

🔧 安装教程

通过 Smithery 安装

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

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

🐞 调试方式

无明确调试步骤,建议检查依赖安装和运行命令是否正确执行。

许可证

该项目遵循 Apache-2.0 开源许可条款,请参阅 Apache-2.0 了解完整条款。