CleanURI URL缩短FastMCP服务器

@Talismanic/cleanuri-url-shortener-mcp

0 Stars 387 次浏览 Talismanic 更新于 2026-08-23

提供了一个使用 CleanURI API 缩短 URL 的简单工具，该工具设计为 FastMCP 服务器运行，可以与基于代理或工具的系统集成。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

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

该服务需要配置环境变量：DOCKER_CONTAINER

可用工具（1 个）

该服务在 MCP 协议中暴露的工具，AI 可按需调用

shorten 1 个参数需填 1 项 Shorten a URL using the cleanuri API. Args: original_url: The URL to shorten.

Shorten a URL using the cleanuri API. Args: original_url: The URL to shorten.

必填参数：original_url

服务介绍

URL 短链接 MCP 工具

该项目提供了一个使用 CleanURI API 的简单 URL 缩短工具，并设计为作为 FastMCP 服务器工具运行。

✨ 特性

使用 CleanURI API 缩短任何给定的 URL。
通过 FastMCP 作为工具暴露功能。
包括适当的错误处理和响应验证。
设计通过 stdio 传输方式运行，以便与代理或基于工具的系统集成。

🚀 使用方法

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

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

查看源码项目主页