ShortURL MCP Integration Guide

MCP (Model Context Protocol) is a model context protocol launched by Anthropic that allows AI models (such as Claude, GPT, etc.) to call external tools through a standardized interface. With the ShortURL MCP Server provided by AceData Cloud, you can directly generate short links in AI clients like Claude Desktop, VS Code, Cursor, and more.

Feature Overview

The ShortURL MCP Server offers the following core features:

  • Single URL Shortening — Convert long URLs into short, easy-to-share links
  • Batch URL Shortening — Shorten multiple URLs at once (up to 10)
  • Usage Guide — Access complete usage instructions and best practices
  • API Information — View API service details and error code explanations

Prerequisites

Before use, you need to obtain an AceData Cloud API Token:

  1. Register or log in to the AceData Cloud Platform
  2. Go to the ShortURL API page
  3. Click "Acquire" to get your API Token (free quota granted on first application)

Installation and Configuration

Method 1: pip Installation (Recommended)

pip install mcp-shorturl

Method 2: Source Installation

git clone https://github.com/AceDataCloud/ShortURLMCP.git
cd ShortURLMCP
pip install -e .

After installation, you can start the service using the mcp-shorturl command.

Using in Claude Desktop

Edit the Claude Desktop configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the following configuration:

{
  "mcpServers": {
    "shorturl": {
      "command": "mcp-shorturl",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your API Token"
      }
    }
  }
}

If using uvx (no need to pre-install packages):

{
  "mcpServers": {
    "shorturl": {
      "command": "uvx",
      "args": ["mcp-shorturl"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your API Token"
      }
    }
  }
}

Save the configuration and restart Claude Desktop to use ShortURL-related tools in conversations.

Using in VS Code / Cursor

Create .vscode/mcp.json in your project root directory:

{
  "servers": {
    "shorturl": {
      "command": "mcp-shorturl",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your API Token"
      }
    }
  }
}

Or use uvx:

{
  "servers": {
    "shorturl": {
      "command": "uvx",
      "args": ["mcp-shorturl"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your API Token"
      }
    }
  }
}

Available Tools

Tool Name Description
shorturl_create Shorten a single URL
shorturl_batch_create Batch shorten multiple URLs (up to 10)
shorturl_get_usage_guide Get the complete usage guide
shorturl_get_api_info Get API service details

Usage Examples

After configuration, you can directly invoke these functions in AI clients using natural language, for example:

  • "Please shorten this link for me"
  • "Batch shorten these 5 URLs"
  • "Generate a short link for sharing"

More Information