Cleanuri Url Shortener Mcp
What is Cleanuri Url Shortener Mcp
cleanuri-url-shortener-mcp is a URL shortening tool that utilizes the CleanURI API to generate shortened URLs. It is designed to operate as a FastMCP server tool.
Use cases
Use cases include shortening URLs for social media sharing, creating clean links for marketing campaigns, and integrating URL shortening functionality in applications or websites.
How to use
To use cleanuri-url-shortener-mcp, install it via Smithery or manually using Python and FastMCP. After installation, run the server with the provided commands, either through Python or Docker.
Key features
Key features include the ability to shorten any URL using the CleanURI API, proper error handling, response validation, and integration capabilities with agent or tool-based systems via stdio transport.
Where to use
cleanuri-url-shortener-mcp can be used in various fields including web development, digital marketing, and any application requiring URL shortening services.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Cleanuri Url Shortener Mcp
cleanuri-url-shortener-mcp is a URL shortening tool that utilizes the CleanURI API to generate shortened URLs. It is designed to operate as a FastMCP server tool.
Use cases
Use cases include shortening URLs for social media sharing, creating clean links for marketing campaigns, and integrating URL shortening functionality in applications or websites.
How to use
To use cleanuri-url-shortener-mcp, install it via Smithery or manually using Python and FastMCP. After installation, run the server with the provided commands, either through Python or Docker.
Key features
Key features include the ability to shorten any URL using the CleanURI API, proper error handling, response validation, and integration capabilities with agent or tool-based systems via stdio transport.
Where to use
cleanuri-url-shortener-mcp can be used in various fields including web development, digital marketing, and any application requiring URL shortening services.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
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
stdiotransport for integration with agent or tool-based systems.
🚀 Usage
1. Requirements
- Python 3.10+
httpxfastmcp
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" ] } } }
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
