A
securityA
licenseA
qualityEnables AI agents to create, update, and manage short links through your Dub.co account, allowing for creation, modification, and deletion of custom shortened URLs.
Last updated -
34
MIT License
This server is a URL Shortener MCP that provides a tool to shorten URLs using the CleanURI API.
Shorten URLs: Takes an
original_urlas input and returns a shortened versionFastMCP Integration: Designed to run as a FastMCP server tool for integration with agent or tool-based systems
Error Handling: Includes proper error handling and response validation
Multiple Installation Options: Can be installed via Smithery, manually with Python, or using Docker
Claude Desktop Integration: Can be easily added to Claude Desktop for streamlined usage
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"
]
}
}
}
Related MCP Servers
- -securityAlicense-qualityA zero-configuration tool that automatically converts FastAPI endpoints into Model Context Protocol (MCP) tools, enabling AI systems to interact with your API through natural language.Last updated -1MIT License
- -securityAlicense-qualityA lightweight MCP server that enables agents to interface with Cloudflare's REST API, allowing management of DNS records and other Cloudflare services.Last updated -116GPL 2.0
- -securityFlicense-qualityA FastAPI server implementing the Model Context Protocol (MCP) for structured tool use, providing utility tools including random number generation, image generation via Azure OpenAI DALL-E, and AI podcast generation.Last updated -