Url Shortener

🚀 Short URL Shortening Tool MCP Server

This project offers a simple URL shortening tool that utilizes the CleanURI API and is designed to run on the FastMCP server tool.

✨ Features

• Shorten any given URL using the CleanURI API.
• Expose the functionality through FastMCP.
• Include appropriate error handling and response validation.
• Designed to run via stdio transmission for integration with proxy or tool-based systems.

🚀 Quick Start

1. Prerequisites

• Python 3.10+
• httpx
• fastmcp

2. Installation

Automatic installation via Smithery:

To automatically install the URL shortening tool on Claude Desktop 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 the Application

uv run main.py

For Docker-based usage, no additional operations are required.

4. Adding to Claude Desktop

Using uv:

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

Using Docker:

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