Skip to main content
Glama
URL Shortener MCP

URL Shortener MCP

by Talismanic

URL 단축기 MCP 도구

대장간 배지

이 프로젝트는 CleanURI API를 사용하여 간단한 URL 단축 도구를 제공하며 FastMCP 서버 도구로 실행되도록 설계되었습니다.

✨ 특징

  • CleanURI API를 사용하여 주어진 URL을 단축합니다.

  • FastMCP를 통해 도구로서의 기능을 공개합니다.

  • 적절한 오류 처리와 응답 검증이 포함됩니다.

  • 에이전트나 도구 기반 시스템과의 통합을 위해 stdio 전송을 통해 실행되도록 설계되었습니다.

Related MCP server: MCP Website Fetcher

🚀 사용법

1. 요구 사항

  • 파이썬 3.10+

  • httpx

  • fastmcp

2. 설치

Smithery를 통해 설치

Smithery 를 통해 Claude Desktop용 URL Shortener Tool을 자동으로 설치하는 방법:

지엑스피1

수동 설치

uv add httpx 'mcp[cli]'

Docker 설치:

docker build -t url-shortener .

3. 달리기

uv run main.py

Docker 기반 사용의 경우 여기서는 아무것도 할 필요가 없습니다.

4. Claude Desktop 추가

자외선으로

{
  "mcpServers": {
    "url-shortener": {
      "command": "/Users/{userName}/.local/bin/uv",
      "args": [
        "--directory",
        "{path_to_repo}/cleanuri-url-shortener-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

도커를 사용하여

{
  "mcpServers": {
    "url-shortener": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--init",
        "-e",
        "DOCKER_CONTAINER=true",
        "url-shortener"
      ]
    }
  }
}

Available Tools

1 tool
shortenB

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

    B3.3/5.0

    Scored across 1 tool

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness2/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      F
      maintenance
      This 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
    • F
      license
      Not graded
      quality
      F
      maintenance
      A 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.
      -
    • A
      license
      A
      quality
      B
      maintenance
      An 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.
      4
      1
      MIT