cleanuri-url-shortener-mcp
3.3
If you are the rightful owner of cleanuri-url-shortener-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
The URL Shortener MCP Tool is a server tool that utilizes the CleanURI API to shorten URLs, designed to run as a FastMCP server tool.
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"
]
}
}
}
