Herramienta MCP para acortar URL

insignia de herrería

Este proyecto proporciona una herramienta sencilla de acortamiento de URL utilizando la API CleanURI y está diseñado para ejecutarse como una herramienta de servidor FastMCP .

✨ Características

Acorta cualquier URL dada utilizando la API CleanURI.
Expone la funcionalidad como una herramienta a través de FastMCP.
Incluye manejo adecuado de errores y validación de respuestas.
Diseñado para ejecutarse a través del transporte stdio para la integración con sistemas basados en agentes o herramientas.

Related MCP server: FastAPI-MCP

🚀 Uso

1. Requisitos

Python 3.10+
httpx
fastmcp

2. Instalación

Instalación mediante herrería

Para instalar la herramienta de acortamiento de URL para Claude Desktop automáticamente a través de Smithery :

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

Instalación manual

uv add httpx 'mcp[cli]'

Instalación de Docker:

docker build -t url-shortener .

3. Corriendo

uv run main.py

Para el uso basado en Docker, no necesitamos hacer nada aquí.

4. Agregar en Claude Desktop

Con los rayos uv

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

Con Docker

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