URL Shortener MCP

# URL Shortener MCP Tool [](https://smithery.ai/server/@Talismanic/cleanuri-url-shortener-mcp) This project provides a simple URL shortening tool using the [CleanURI API](https://cleanuri.com/) and is designed to run as a [FastMCP](https://github.com/multiprompt/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](https://smithery.ai/server/@Talismanic/cleanuri-url-shortener-mcp): ```bash npx -y @smithery/cli install @Talismanic/cleanuri-url-shortener-mcp --client claude ``` ### Manual Installation ```bash 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" ] } } } ```