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 费思量-API, 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 费思量-API API Token:

  1. Register or log in to the 费思量-API 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