URL Shortener

A simple URL shortening tool using the CleanURI API.

Install

Install and configure the MCP from https://github.com/Talismanic/cleanuri-url-shortener-mcp now. Follow the repository's installation instructions, ask me for anything you can't complete yourself, and verify its tools load.

View source on GitHub

README

URL Shortener MCP Tool

This project provides a simple URL shortening tool using the CleanURI API and is designed to run as a FastMCP server tool.

✨ Features

Shortens any given URL using the CleanURI API.
Exposes the functionality as a tool via FastMCP.
Includes proper error handling and response validation.
Designed to run via stdio transport for integration with agent or tool-based systems.

🚀 Usage

1. Requirements

Python 3.10+
httpx
fastmcp

2. Installation

Installing via Smithery

To install URL Shortener Tool for Claude Desktop automatically via Smithery:

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

Manual Installation

uv add httpx 'mcp[cli]'

Docker Installation:

docker build -t url-shortener .

3. Running

uv run main.py

For docker based use, we dont need to do anything here.

4. Adding in Claude Desktop

With the uv

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

With Docker

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