URL Shortener MCP Tool

URL Shortener MCP Tool

このプロジェクトは、CleanURI API を使用したシンプルな URL 短縮ツールを提供し、FastMCP サーバーツールとして動作するように設計されています。

✨ 機能

• CleanURI API を使用して、指定された URL を短縮します。
• FastMCP を介してツールとして機能を公開します。
• 適切なエラー処理とレスポンスの検証を備えています。
• エージェントまたはツールベースのシステムとの統合に向けて、stdio トランスポートで実行するように設計されています。

🚀 使用方法

1. 要件

• Python 3.10+
• httpx
• fastmcp

2. インストール

Smithery 経由でインストール

Smithery 経由で URL Shortener Tool を Claude Desktop に自動的にインストールするには：

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.py

Docker ベースで使用する場合は、ここでは何もする必要はありません。

4. Claude Desktop への追加

uv を使用する場合

{
  "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"
      ]
    }
  }
}