URL Shortener MCP
URL短縮MCPツール
このプロジェクトは、 CleanURI APIを使用したシンプルな URL 短縮ツールを提供し、 FastMCPサーバー ツールとして実行されるように設計されています。
✨ 特徴
CleanURI API を使用して、指定された URL を短縮します。
FastMCP を介してツールとして機能を公開します。
適切なエラー処理と応答検証が含まれます。
エージェントまたはツールベースのシステムとの統合のために
stdioトランスポート経由で実行するように設計されています。
Related MCP server: MCP Website Fetcher
🚀 使用方法
1. 要件
Python 3.10以上
httpxfastmcp
2. インストール
Smithery経由でインストール
Smithery経由で Claude Desktop の URL 短縮ツールを自動的にインストールするには:
npx -y @smithery/cli install @Talismanic/cleanuri-url-shortener-mcp --client claude手動インストール
uv add httpx 'mcp[cli]'Docker インストール:
docker build -t url-shortener .3. ランニング
uv run main.pydocker ベースでの使用の場合、ここで何もする必要はありません。
4. Claude Desktopへの追加
紫外線で
{
"mcpServers": {
"url-shortener": {
"command": "/Users/{userName}/.local/bin/uv",
"args": [
"--directory",
"{path_to_repo}/cleanuri-url-shortener-mcp",
"run",
"main.py"
]
}
}
}Dockerを使用
{
"mcpServers": {
"url-shortener": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"--init",
"-e",
"DOCKER_CONTAINER=true",
"url-shortener"
]
}
}
}Available Tools
1 toolshortenB
Shorten a URL using the cleanuri API.
Args:
original_url: The URL to shorten.
Inputs: original_url (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap between tools. The tool 'shorten' has a single, clear purpose that cannot be confused with any other tool in this set.
Since there is only one tool, naming consistency is inherently perfect. The tool name 'shorten' follows a clear verb-based pattern appropriate for its function, with no other tools to compare against for inconsistency.
A single tool for a URL shortener server is too few for the apparent scope, as it only covers shortening URLs without any complementary operations like retrieving, updating, deleting, or listing shortened URLs. This minimal set limits functionality and may cause agent failures in broader workflows.
The tool surface is severely incomplete for a URL shortener domain. While 'shorten' allows creation, there are no tools for retrieving, updating, deleting, or managing shortened URLs (e.g., get_url, list_urls, delete_url), creating significant gaps that will hinder agent performance in typical use cases.
Maintenance
Related MCP Connectors
Web and URL utilities over MCP: shorten URLs, screenshot pages, read page metadata, encode URLs.
Create, find, update and delete Simple Click Tracker short links from Claude or any MCP client.
MCP server (stdio): fetch web pages as clean readable markdown via the AgentForge API
Related MCP Servers
AlicenseNot gradedqualityFmaintenanceThis project implements a simple MCP server in Go that exposes a single tool (create_short_link) to generate short URLs using the Rebrandly API.MIT- FlicenseNot gradedqualityFmaintenanceA lightweight MCP server implementation that provides a simple tool for fetching website content, demonstrating how tools can be exposed and interacted with using the MCP protocol.-
- AlicenseAqualityBmaintenanceAn MCP server that enables users to shorten long URLs into permanent, shareable links using the AceDataCloud API. It supports both single and batch URL shortening directly within MCP-compatible clients like Claude and VS Code.41MIT
- AlicenseAqualityDmaintenanceMCP server that converts URLs to clean Markdown/Text for LLM agents.579 npm5MIT