cleanuri-url-shortener-mcp

This MCP server will return the shortened URL using cleanuri.

4 stars PythonServers & Infrastructure Updated Nov 1, 2025

Documentation

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:

bash

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

Manual Installation

bash

uv add httpx 'mcp[cli]'

Docker Installation:

code

docker build -t url-shortener .

3. Running

code

uv run main.py

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

4. Adding in Claude Desktop

With the uv

code

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

With Docker

code

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

Frequently asked questions

What is cleanuri-url-shortener-mcp?

cleanuri-url-shortener-mcp is This MCP server will return the shortened URL using cleanuri.

How do I install cleanuri-url-shortener-mcp?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is cleanuri-url-shortener-mcp open source?

Yes — it is hosted on GitHub at https://github.com/Talismanic/cleanuri-url-shortener-mcp and has 4 stars.

Related MCP tools

damn-vulnerable-mcp-server

Damn Vulnerable MCP Server Python-based implementation. Trusted by 1200+ developers. Trusted by 1200+ developers. Trusted by 1200+ developers.

1,209 Python

mysql_mcp_server

A Model Context Protocol (MCP) server that enables secure interaction with MySQL databases Python-based implementation. Trusted by 900+ developers.

964 Python

aimcpmodel-context-protocol+1

supabase-mcp-server

Query MCP enables end-to-end management of Supabase via chat interface: read & write query executions, management API support, automatic migration versioning...

805 Python

cursormodel-context-protocolsupabase+1