Picoli MCP

🚀 picoli-mcp

picoli-mcp 是為 picoli.site 打造的 MCP 服務器，為 AI 代理提供 URL 縮短和點擊分析功能。藉助它，你可以直接通過 AI 助手縮短 URL、跟蹤點擊情況並分析鏈接性能。

🚀 快速開始

🔍 獲取 API 密鑰

首先，前往 picoli.site 創建一個賬戶，然後從儀表盤獲取你的 API 密鑰。

⚙️ 配置 MCP 客戶端

Claude Desktop / Claude Code

在你的 MCP 配置中添加以下內容：

{
  "mcpServers": {
    "picoli": {
      "command": "npx",
      "args": ["-y", "picoli-mcp"],
      "env": {
        "PICOLI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

在 .cursor/mcp.json 文件中添加以下內容：

{
  "mcpServers": {
    "picoli": {
      "command": "npx",
      "args": ["-y", "picoli-mcp"],
      "env": {
        "PICOLI_API_KEY": "your-api-key-here"
      }
    }
  }
}

✨ 主要特性

shorten_url

可創建短 URL，還能選擇自定義後綴。 示例提示語：

• "縮短 https://example.com/very-long-article-url"
• "為 https://my-site.com 創建一個短鏈接，後綴為 'launch'"

shorten_urls

可一次性創建多個短 URL（最多 500 個）。 示例提示語：

• "縮短這 3 個 URL: ..."

get_link_stats

獲取特定鏈接的點擊統計信息（不包含機器人流量）。 示例提示語：

• "我的 'launch' 鏈接獲得了多少次點擊？"
• "顯示這些後綴鏈接的統計信息：launch、demo、blog-post"

list_links

列出所有縮短後的 URL，並顯示點擊次數，支持分頁查看。 示例提示語：

• "顯示我所有的短鏈接"
• "按點擊次數對我的鏈接進行排序並列出"

get_analytics

獲取分析概覽，包括前 10 個鏈接、每日點擊趨勢和總數。 示例提示語：

• "顯示我本週的鏈接分析數據"
• "我表現最佳的鏈接有哪些？"
• "提供 2026 年 1 月 1 日至 2026 年 1 月 31 日的點擊統計信息"

📚 詳細文檔

環境變量

📦 安裝指南

開發環境搭建

git clone https://github.com/yun/picoli-mcp.git
cd picoli-mcp
npm install
npm run build

本地測試

PICOLI_API_KEY=your-key npx tsx src/index.ts

📄 許可證

本項目採用 MIT 許可證。