create_short_url
Create shortened URLs with custom domains and codes to simplify long links for sharing and tracking purposes.
Instructions
创建一个新的短网址。支持自定义域名、短代码、标题和描述信息。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| original_url | Yes | 原始URL地址（要缩短的长链接） | |
| domain | Yes | 短网址使用的域名（必填） | |
| custom_code | No | 自定义短代码（可选，如果不提供将自动生成） | |
| title | Yes | 短网址的标题（必填） | |
| description | No | 短网址的描述信息（可选） | |
| expire_at | No | 过期时间（可选，ISO 8601格式，不填表示永不过期） |
Implementation Reference
- src/mcp/tools/createShortUrl.js:67-98 (handler)The handler function for the 'create_short_url' MCP tool. It logs the call, invokes the short link service to create the URL, formats the response with success status, data, and metadata.
handler: async function (args) { logger.info('MCP工具调用: create_short_url', { args }); return ErrorHandler.asyncWrapper(async () => { // 调用服务层创建短链接 const result = await defaultShortLinkService.createShortUrl(args); // 格式化返回结果 return { success: true, message: '短网址创建成功', data: { id: result.id, short_code: result.short_code, short_url: result.short_url, original_url: result.original_url, title: result.title, description: result.description, domain: result.domain, expire_at: result.expire_at, is_active: result.is_active, click_count: result.click_count, created_at: result.created_at, updated_at: result.updated_at, }, meta: { operation: 'create_short_url', timestamp: new Date().toISOString(), }, }; })(); }, - JSON Schema defining the input parameters for the 'create_short_url' tool, including properties, descriptions, constraints, and required fields.
inputSchema: { type: 'object', properties: { original_url: { type: 'string', description: '原始URL地址（要缩短的长链接）', format: 'uri', examples: ['https://www.example.com/very/long/path', 'https://github.com/user/repo'], }, domain: { type: 'string', description: '短网址使用的域名（必填）', pattern: '^[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$', examples: ['dwz.test', 'link.example.com'], }, custom_code: { type: 'string', description: '自定义短代码（可选，如果不提供将自动生成）', pattern: '^[a-zA-Z0-9]{3,50}$', examples: ['abc123', 'mylink', 'promo2024'], }, title: { type: 'string', description: '短网址的标题（必填）', minLength: 1, maxLength: 200, examples: ['产品官网', '活动页面', '技术文档'], }, description: { type: 'string', description: '短网址的描述信息（可选）', maxLength: 500, examples: ['这是我们的新产品页面', '2024年春节促销活动'], }, expire_at: { type: 'string', description: '过期时间（可选，ISO 8601格式，不填表示永不过期）', format: 'date-time', examples: ['2024-12-31T23:59:59Z', '2025-01-01T00:00:00+08:00'], }, }, required: ['original_url', 'domain', 'title'], }, - src/mcp/server.js:72-88 (registration)The registerTools method registers the 'create_short_url' tool (imported as createShortUrlTool) along with others into the server's tools Map, making it available for MCP requests.
registerTools() { const tools = [ createShortUrlTool, getUrlInfoTool, listShortUrlsTool, deleteShortUrlTool, batchCreateShortUrlsTool, listDomainsTool, ]; for (const tool of tools) { this.tools.set(tool.name, tool); logger.debug(`注册工具: ${tool.name}`); } logger.info(`已注册 ${tools.length} 个工具`); } - Core helper function in the ShortLinkService that performs parameter validation, URL normalization, HTTP POST to the backend API to create the short URL, and handles the response or errors.
async createShortUrl(params) { try { // 验证参数 const validatedParams = validateOrThrow('createShortUrl', params); // 标准化 URL validatedParams.original_url = normalizeUrl(validatedParams.original_url); logger.info('开始创建短链接:', { original_url: validatedParams.original_url, domain: validatedParams.domain, custom_code: validatedParams.custom_code, }); // 发送请求 const response = await this.httpClient.post( getApiUrl('/short_links'), validatedParams ); // 处理响应 const result = this.handleApiResponse(response, '创建短链接'); logger.info('短链接创建成功:', { id: result.id, short_code: result.short_code, short_url: result.short_url, }); return result; } catch (error) { logger.error('创建短链接失败:', error); const handledError = ErrorHandler.handle(error); throw ErrorHandler.createMcpErrorResponse(handledError, error); } }