URL短縮MCPツール

鍛冶屋のバッジ

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

✨ 特徴

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

Related MCP server: FastAPI-MCP

🚀 使用方法

1. 要件

Python 3.10以上
httpx
fastmcp

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

Dockerを使用

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