Cleanuri URL Shortener

🚀 短リンク縮小ツール MCP サーバー

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

✨ 主な機能

• CleanURI API を使用して、任意の URL を短縮します。
• FastMCP を通じて機能インターフェースを提供します。
• 適切なエラー処理とレスポンス検証を含みます。
• stdio を介して動作するように設計されており、プロキシやツールシステムとの統合が容易です。

🚀 クイックスタート

1. 前提条件

• Python 3.10 以上
• httpx
• fastmcp

2. インストール

Smithery を通じた自動インストール

Smithery 上で Claude デスクトップ用に 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.py Docker を使用する場合は、追加の操作は必要ありません。

4. Claude デスクトップに追加

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