Zip1

官方

一個免費的網址縮短服務

造訪 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。使用自然語言指令縮短網址、取得分析資料並管理連結。

🤖

AI 驅動的網址管理

像與 AI 對話一樣與你的網址縮短器交談

✨ 自然語言介面 — 無需 API 語法
⚡ 從你的 AI 助理即時縮短網址
📊 透過簡單提示隨需取得分析資料
🔒 以對話方式建立受密碼保護的連結

⚡ 快速設定

適用於 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-to-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 的用戶端皆可連線。

伺服器詳細資料

設定項目	值
伺服器網址	`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 使用的自然語言提示：

建立短網址

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

Claude 的回應：
✅ 短網址已建立：https://zip1.io/\[code\]
🔤 產生的代碼：[code]
🔗 原始網址：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 的回應：
✅ 短網址已建立：https://zip1.io/docs
📝 自訂別名：docs
🔒 密碼保護：是
🔗 原始網址：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 次點擊

網址驗證

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

Claude 的回應：
❌ 網址無效：必須包含 http:// 或 https:// 協定及有效網域

🛠️ 可用工具

zip1.io MCP 伺服器提供四個 Claude 可使用的工具：

工具	說明	使用範例
`create_short_url`	建立短網址，可選擇自訂別名、密碼和最大點擊次數	「使用別名『mylink』縮短此網址」
`get_url_stats`	取得詳細分析資料，包括點擊次數、國家／地區和時間戳記	「取得短代碼『abc123』的統計資料」
`validate_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 相同的安全基礎架構

💡 使用案例

📝 內容創作

在撰寫部落格文章、文件或社群媒體內容時，無需離開 AI 助理即可產生短網址。

📊 快速分析

在對話中詢問連結成效。「我的活動連結獲得多少次點擊？」

🔐 安全分享

在團隊聊天中分享敏感資訊時，即時建立受密碼保護的連結。

🎯 活動管理

使用自然語言指令為行銷活動建立自訂別名網址。

🔍 疑難排解

遇到速率限制錯誤？

MCP 端點限制為每分鐘 30 次請求
等待一分鐘後再試

工具未出現在 Claude Code 中？

確認 MCP 伺服器網址可存取
嘗試在瀏覽器中造訪 https://zip1.io/mcp
使用 claude mcp list 驗證你的 MCP 設定

📚 資源與文件

官方 MCP 文件 — 深入瞭解模型上下文協定
MCP Python SDK — 建立你自己的 MCP 伺服器
REST API 文件 — 傳統 API 存取

準備好開始了嗎？

立即將 zip1.io 新增至 Claude Code，開始使用 AI 縮短網址

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