
URL Shortener MCP Tool

2025.03.25
1
PythonURL 缩短工具开发效率
cleanuri-url-shortener-mcp 是一个基于 CleanURI API 的 URL 缩短工具,设计为 FastMCP 服务器工具运行。它能够将任何给定的 URL 缩短,并通过 FastMCP 将功能作为工具暴露出来。该工具包含适当的错误处理和响应验证,设计为通过 `stdio` 传输运行,以便与代理或基于工具的系统集成。
View on GitHub
Overview
✨ 核心功能
- 使用 CleanURI API 缩短任何给定的 URL。
- 通过 FastMCP 将功能作为工具暴露。
- 包含适当的错误处理和响应验证。
- 设计为通过
stdio
传输运行,以便与代理或基于工具的系统集成。
🚀 使用场景
- 需要快速缩短 URL 的场景。
- 集成到代理或基于工具的系统中的 URL 缩短需求。
🛠️ 工具列表
- CleanURI API:用于 URL 缩短的核心 API。
- FastMCP:用于将功能作为工具暴露的框架。
❓ 常见问题解答
无明确常见问题解答部分。
📦 使用依赖
- Python 3.10+
httpx
fastmcp
🔧 安装教程
通过 Smithery 安装
npx -y @smithery/cli install @Talismanic/cleanuri-url-shortener-mcp --client claude
手动安装
uv add httpx 'mcp[cli]'
Docker 安装
docker build -t url-shortener .
🏃 运行
uv run main.py
在 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"
]
}
}
}
🐞 调试方式
无明确调试步骤,建议检查依赖安装和运行命令是否正确执行。