URL Shortener

Ferramenta MCP de Encurtador de URL

Este projeto fornece uma ferramenta simples de encurtamento de URLs usando a API CleanURI e foi projetado para funcionar como uma ferramenta de servidor FastMCP.

✨ Recursos

• Encurta qualquer URL fornecida usando a API CleanURI.
• Expõe a funcionalidade como uma ferramenta via FastMCP.
• Inclui tratamento adequado de erros e validação de respostas.
• Projetado para ser executado via transporte stdio para integração com sistemas baseados em agentes ou ferramentas.

🚀 Uso

1. Requisitos

• Python 3.10+
• httpx
• fastmcp

2. Instalação

Instalação via Smithery

Para instalar a Ferramenta de Encurtador de URL para Claude Desktop automaticamente via Smithery:

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

Instalação Manual

uv add httpx 'mcp[cli]'

Instalação via Docker:

docker build -t url-shortener .

3. Execução

uv run main.py

Para uso baseado em Docker, não precisamos fazer nada aqui.

4. Adicionando no Claude Desktop

Com o uv

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

Com Docker

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