Zip1 MCP Server

官方

一个免费的URL缩短器

访问 zip1.io

文档

缩短
API
MCP
统计
联系

🤖 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 http://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

添加此配置：

claude_desktop_config.json

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

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

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

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

zip1-mcp-proxy.js

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

const MCP_URL = 'http://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	http://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 http://zip1.io/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

创建短 URL

curl -X POST http://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 客户端示例

Python 脚本

import requests

MCP_URL = "http://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 Code

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

Claude Desktop (使用 mcp-client)

{
  "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	生成一个随机的短代码建议	"生成一个随机短代码"

🔧 技术细节

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 可访问
尝试在浏览器中访问 http://zip1.io/mcp
使用 claude mcp list 验证您的 MCP 配置

📚 资源和文档

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

准备好开始了吗？

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

快速设置