MCPgee
MCPgee
MCPgeeMCPgee

Short URL

v1.0.0•APIs•stable

简单易用的短链接生成工具，完全开源、免费、无需登录，可私有化部署，链接永久有效！

aiclaudemcpmodel-context-protocolshort-url
Share:
19
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Short URL?

Short URL is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 简单易用的短链接生成工具，完全开源、免费、无需登录，可私有化部署，链接永久有效！

简单易用的短链接生成工具，完全开源、免费、无需登录，可私有化部署，链接永久有效！

This server falls under the APIs category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • 简单易用的短链接生成工具，完全开源、免费、无需登录，可私有化部署，链接永久有效！

Use Cases

URL shortening service
Link management
URL tracking
fengzhongsen

Maintainer

LicenseMIT
Languagejavascript
Versionv1.0.0
UpdatedMar 12, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx short-url

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Short URL

Short URL MCP Server is a JavaScript-based MCP server that connects AI assistants to a self-hosted URL shortening service, enabling programmatic creation and management of short links with permanent validity. The server is part of a full-stack monorepo including a React frontend, an Express and Redis backend, and a dedicated MCP server component (short-mcp-server) that bridges AI clients to the shortening API. Developers who want a privacy-respecting, self-deployed link shortener that AI assistants can operate through natural language will find this an ideal open-source alternative to commercial services.

Prerequisites

  • Node.js 16 or later installed
  • Redis server running (locally or via Docker)
  • The short-url backend service deployed and accessible
  • An API key generated from the short-url application after logging in
  • An MCP-compatible client such as Claude Desktop or VS Code
1

Clone and set up the short-url backend

Clone the repository and install dependencies for the backend service. A Redis instance must be running for the backend to store links.

git clone https://github.com/fengzhongsen/short-url
cd short-url
npm install
2

Configure environment variables

Create a .env file with your Redis connection details and other required configuration. Adjust PORT, REDIS_HOST, and REDIS_PORT for your deployment.

PORT=3001
REDIS_HOST=127.0.0.1
REDIS_PORT=6379
JWT_SECRET=short-url-jwt-secret
JWT_EXPIRES_IN=2h
ENCRYPT_KEY=short-url-encrypt-key
USER_URL_LIMIT=10
3

Start the backend service

Start the short-url backend server.

npm start
4

Generate an API key

Register an account and log in to the short-url web interface (default at http://localhost:3001). Navigate to your account settings to generate an API key for MCP server authentication.

5

Add the MCP server to your client configuration

Add the short-mcp-server entry to your MCP client config, providing the API origin and your generated API key.

{
  "mcpServers": {
    "short-url": {
      "command": "npx",
      "args": ["-y", "short-mcp-server"],
      "env": {
        "API_ORIGIN": "http://localhost:3001",
        "API_KEY": "your_generated_api_key"
      }
    }
  }
}

Short URL Examples

Client configuration

Configuration block for claude_desktop_config.json connecting to a locally running short-url backend with a generated API key.

{
  "mcpServers": {
    "short-url": {
      "command": "npx",
      "args": ["-y", "short-mcp-server"],
      "env": {
        "API_ORIGIN": "http://localhost:3001",
        "API_KEY": "your_generated_api_key_here"
      }
    }
  }
}

Prompts to try

Sample prompts for creating and managing short links through the AI assistant.

- "Shorten this URL for me: https://example.com/very/long/path/to/some/page"
- "Create a short link for https://my-project.com/documentation"
- "List all the short URLs I have created"
- "How many short links do I have remaining in my quota?"
- "Delete the short URL that points to my old blog post"

Troubleshooting Short URL

MCP server returns connection refused error

Ensure the short-url backend is running on the port specified in API_ORIGIN. Start the backend with 'npm start' from the short-url directory and verify it is listening on port 3001 (or your configured PORT).

API key authentication fails

Generate a new API key by logging into the short-url web interface and checking the account/settings section. Ensure the API_KEY environment variable in your MCP config matches exactly what the dashboard shows.

Redis connection error on backend startup

Confirm Redis is running with 'redis-cli ping'. If Redis is not installed, install it with 'brew install redis' (macOS) or 'apt install redis-server' (Ubuntu) and start the service before launching the backend.

Frequently Asked Questions about Short URL

What is Short URL?

Short URL is a Model Context Protocol (MCP) server that 简单易用的短链接生成工具，完全开源、免费、无需登录，可私有化部署，链接永久有效！ It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Short URL?

Follow the installation instructions on the Short URL GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Short URL?

Short URL works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Short URL free to use?

Yes, Short URL is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Short URL Alternatives — Similar APIs Servers

Looking for alternatives to Short URL? Here are other popular apis servers you can use with Claude, Cursor, and VS Code.

Kong

★ 43.4k

🦍 The API and AI Gateway

API Mega List

★ 5.4k

This GitHub repo is a powerhouse collection of APIs you can start using immediately to build everything from simple automations to full-scale applications. One of the most valuable API lists on GitHub—period. 💪

Fetch

★ 5.4k

Fetch web content and convert to markdown for AI consumption

Fusio

★ 2.1k

Self-Hosted API Management for Builders

Korean Law

★ 1.8k

국가법령정보MCP v4.0 | 법제처 41개 API → 17개 MCP 도구. 법령·판례·조례 검색 + LLM 환각 방지 인용검증 + 조문 영향 그래프(impact_map) + 시점 비교 자동 diff(time_travel) + 시민 5단계 실행 가이드(action_plan) | 41 Korean legal APIs → 17 MCP tools

RuleGo

★ 1.5k

⛓️RuleGo is a lightweight, high-performance, embedded, next-generation component orchestration rule engine framework for Go.

Browse More APIs MCP Servers

Explore all apis servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

APIsBrowse All Servers

Quick Config Preview

{ "mcpServers": { "short-url": { "command": "npx", "args": ["-y", "short-url"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Short URL?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides