URL Shortener MCP

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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

Provides a simple tool to shorten URLs using the CleanURI API, designed to run as a FastMCP server that can be integrated with agent or tool-based systems.

  1. ✨ Features
    1. 🚀 Usage
      1. Requirements
    2. Installation
      1. Installing via Smithery
      2. Manual Installation
      3. Docker Installation:
      4. Running
      5. Adding in Claude Desktop

    Related MCP Servers

    • -
      security
      A
      license
      -
      quality
      A server based on the MCP protocol that uses the Brave API for web search functionality.
      Last updated -
      6
      Python
      MIT License
      • Apple
      • Linux
    • -
      security
      A
      license
      -
      quality
      A lightweight MCP server for managing DNS records, purging cache, and interacting with the Cloudflare API through natural language commands.
      Last updated -
      13
      TypeScript
      MIT License
    • -
      security
      A
      license
      -
      quality
      A Python-based MCP server that crawls websites to extract and save content as markdown files, with features for mapping website structure and links.
      Last updated -
      1
      Python
      MIT License
    • -
      security
      A
      license
      -
      quality
      A Python implementation of an MCP server that extracts webpage content, removes ads and non-essential elements, and transforms it into clean, LLM-optimized Markdown.
      Last updated -
      1
      Python
      MIT License
      • Linux
      • Apple

    View all related MCP servers

    ID: rbwxqgcc7n