Zip1

官方

一个免费的URL缩短器

访问 zip1.io试用此 MCP赞助

你可以用 Zip1 MCP 做什么？

缩短网址 — 让您的助手使用 create_short_url 从任何有效 URL 创建短链接。
自定义别名与密码 — 通过 create_short_url 请求带有自定义别名和可选密码保护的品牌短链接。
检查 URL 有效性 — 在创建链接之前，使用 validate_url 工具询问某个 URL 是否可以被缩短。
获取链接分析 — 使用 get_url_stats 获取任何短代码的点击次数、独立访客数和热门国家/地区。
生成短代码 — 请求一个随机短代码建议，用作自定义别名。

文档

🤖 AI 集成（MCP）

通过模型上下文协议（MCP），您可以直接从 Claude 等 AI 助手中使用 zip1.io。使用自然语言命令即可缩短 URL、获取分析数据和管理链接。

🤖

AI 驱动的 URL 管理

像与 AI 对话一样与您的 URL 缩短器交流

✨ 自然语言界面——无需 API 语法
⚡ 从您的 AI 助手中即时缩短 URL
📊 通过简单提示按需获取分析数据
🔒 通过对话创建受密码保护的链接

⚡ 快速设置

适用于 Claude Code（推荐）

Claude Code 直接通过 CLI 支持 HTTP MCP 服务器。只需运行：

claude mcp add --transport http zip1 https://zip1.io/mcp

验证安装：

claude mcp list

✅ 就这样！ 您现在可以直接从 Claude Code 中使用 zip1.io。

适用于 Claude Desktop

⚠️ 需要代理： Claude Desktop 仅支持基于 stdio 的 MCP 服务器，不支持 HTTP 服务器。您需要一个本地代理来桥接连接。

选项 1：使用 mcp-client-cli（推荐）

安装 MCP 客户端 CLI 工具以将 stdio 桥接到 HTTP：

npm install -g @modelcontextprotocol/client-cli

然后编辑您的 Claude Desktop 配置文件：

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

添加此配置：

{
  "mcpServers": {
    "zip1": {
      "command": "mcp-client",
      "args": ["https://zip1.io/mcp"]
    }
  }
}

重启 Claude Desktop，zip1.io 工具即可使用。

选项 2：自定义 Node.js 代理

对于高级用户，创建自定义 stdio 到 HTTP 的桥接脚本：

#!/usr/bin/env node
const https = require('https');
const readline = require('readline');

const MCP_URL = 'https://zip1.io/mcp';

const rl = readline.createInterface({
  input: process.stdin,
  output: process.stdout,
  terminal: false
});

rl.on('line', (line) => {
  const request = JSON.parse(line);

  const options = {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    }
  };

  const req = https.request(MCP_URL, options, (res) => {
    let data = '';
    res.on('data', (chunk) => data += chunk);
    res.on('end', () => {
      console.log(data);
    });
  });

  req.on('error', (error) => {
    console.error(JSON.stringify({
      jsonrpc: '2.0',
      id: request.id,
      error: { code: -32000, message: error.message }
    }));
  });

  req.write(JSON.stringify(request));
  req.end();
});

使其可执行并添加到您的 Claude Desktop 配置中：

chmod +x zip1-mcp-proxy.js

{
  "mcpServers": {
    "zip1": {
      "command": "node",
      "args": ["/path/to/zip1-mcp-proxy.js"]
    }
  }
}

⚙️ 服务器配置

zip1.io MCP 服务器作为 HTTP 端点提供，任何兼容 MCP 的客户端都可以连接。

服务器详情

配置项	值
服务器 URL	`https://zip1.io/mcp`
传输方式	HTTP（可流式）
协议版本	MCP 2024-11-05
消息格式	JSON-RPC 2.0
认证	无（限速）
速率限制	每个 IP 每分钟 30 次请求
可用工具	4（create_short_url、get_url_stats、validate_url、generate_short_code）

与其他 MCP 客户端一起使用

任何支持 HTTP 传输的兼容 MCP 客户端都可以连接到 zip1.io。以下是一些示例：

直接 HTTP 请求（curl）

curl -X POST https://zip1.io/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

curl -X POST https://zip1.io/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "create_short_url",
      "arguments": {
        "url": "https://example.com",
        "alias": "my-link"
      }
    }
  }'

Python 客户端示例

import requests

MCP_URL = "https://zip1.io/mcp"

def call_mcp_tool(tool_name, arguments):
    payload = {
        "jsonrpc": "2.0",
        "id": 1,
        "method": "tools/call",
        "params": {
            "name": tool_name,
            "arguments": arguments
        }
    }

    response = requests.post(MCP_URL, json=payload)
    return response.json()

# Example usage
result = call_mcp_tool("create_short_url", {
    "url": "https://github.com/anthropics/claude-mcp",
    "alias": "mcp-docs"
})

print(result)

自托管配置

如果您正在运行自己的 zip1.io 实例，请将客户端配置为指向您的实例：

claude mcp add --transport http zip1 https://your-domain.com/mcp

{
  "mcpServers": {
    "zip1-local": {
      "command": "mcp-client",
      "args": ["http://localhost:8000/mcp"]
    }
  }
}

💬 对话示例

以下是一些您可以与 Claude 一起使用的自然语言提示：

创建短 URL

"Shorten https://github.com/anthropics/claude-mcp for me"

Claude 的响应：
✅ 短 URL 已创建：https://zip1.io/\[code\]
🔤 生成的代码：[code]
🔗 原始 URL：https://github.com/anthropics/claude-mcp
📊 查看统计：https://zip1.io/stats/\[code\]

自定义别名和密码

"Create a short URL for https://docs.myapp.com with alias 'docs' and password 'team2024@'"

Claude 的响应：
✅ 短 URL 已创建：https://zip1.io/docs
📝 自定义别名：docs
🔒 密码保护：是
🔗 原始 URL：https://docs.myapp.com

获取分析数据

"Show me the stats for short code 'docs'"

Claude 的响应：
📊 统计信息：https://zip1.io/docs
👆 总点击量：127
👤 独立点击量：89
🔒 密码保护：是
📅 创建时间：2024-01-15T10:30:00

🌍 热门国家/地区：
1. 美国：54 次点击
2. 英国：23 次点击
3. 加拿大：18 次点击

URL 验证

"Can I shorten ftp://myserver.com/file.zip?"

Claude 的响应：
❌ URL 无效：必须包含 http:// 或 https:// 协议以及有效域名

🛠️ 可用工具

zip1.io MCP 服务器提供四个工具供 Claude 使用：

工具	描述	使用示例
`create_short_url`	创建短 URL，支持可选的自定义别名、密码和最大点击次数	"使用别名 'mylink' 缩短此 URL"
`get_url_stats`	检索详细分析数据，包括点击量、国家/地区和时间戳	"获取短代码 'abc123' 的统计信息"
`validate_url`	检查 URL 是否有效且可以缩短	"我可以缩短 example.com 吗？"
`generate_short_code`	生成随机短代码建议	"生成一个随机短代码"

description 上的 create_short_url 是您自己集成的可选私人备注，最多 100 个字符。它不会显示在链接的公共页面上。请勿包含您不希望存储的个人数据。创建响应会返回该备注。

🔧 技术细节

MCP 端点

GET /mcp

返回服务器信息、可用工具和配置详情。

协议信息

协议版本： MCP 2024-11-05
传输方式： 可流式 HTTP
消息格式： JSON-RPC 2.0
速率限制： 每个 IP 每分钟 30 次请求

安全性

所有通信均使用 HTTPS 加密
密码在存储前使用 bcrypt 进行哈希处理
速率限制可防止滥用
与 REST API 相同的安全基础设施

💡 使用场景

📝 内容创作

在撰写博客文章、文档或社交媒体内容时生成短 URL，无需离开您的 AI 助手。

📊 快速分析

在对话中询问链接表现。"我的活动链接获得了多少次点击？"

🔐 安全共享

在团队聊天中分享敏感信息时，即时创建受密码保护的链接。

🎯 活动管理

使用自然语言命令为营销活动创建自定义别名的 URL。

🔍 故障排除

遇到速率限制错误？

MCP 端点限制为每分钟 30 次请求
等待一分钟后再试

工具未出现在 Claude Code 中？

确保 MCP 服务器 URL 可访问
尝试在浏览器中访问 https://zip1.io/mcp
使用 claude mcp list 验证您的 MCP 配置

📚 资源与文档

官方 MCP 文档 - 了解更多关于模型上下文协议的信息
MCP Python SDK - 构建您自己的 MCP 服务器
REST API 文档 - 传统 API 访问

准备好开始了吗？

立即将 zip1.io 添加到 Claude Code，开始使用 AI 缩短 URL

claude mcp add --transport http zip1 https://zip1.io/mcp