Picoli Mcp

io.github.amaterous由 GitHub 帳號 amaterous 發布v1.0.1更新於 Oct 27, 2026

MCP server for picoli.site - URL shortening and click analytics for AI agents

已驗證STDIO僅桌面資料與分析商業與電商

概覽

AI 產生的概覽

針對 picoli.site 的 MCP 伺服器，讓 AI 助理縮短網址、建立自訂短連結並查看連結點擊分析。

可以做什麼
  • 建立短連結，可自訂 slug
  • 一次批次建立最多 500 條短連結
  • 查詢指定連結的點擊統計（已排除機器人流量）
  • 分頁列出所有短連結與點擊次數
  • 取得分析總覽：前 10 名連結、每日點擊趨勢與區間總計
適用情境
適合讓助理為行銷活動或分享產生短連結，或在不開啟 picoli.site 後台的情況下回報現有短連結的成效。
執行需求
以 stdio 方式在本機執行，通常透過 npx 啟動，需要 Node.js。需要 picoli.site 帳號與 API 金鑰，透過環境變數 PICOLI_API_KEY 傳入。選用環境變數 PICOLI_BASE_URL 可指向自架執行個體而非預設服務。需要能連線至 picoli.site API 的網路。
安裝前請注意
API 金鑰是寫入用戶端設定的機密，請勿放在共用檔案中。建立短連結會在你的 picoli.site 帳號寫入資料，批次建立一次最多可新增 500 條連結。連結資料與分析請求會傳送至 picoli.site，或 PICOLI_BASE_URL 指定的主機。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Picoli Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

picoli-mcp

MCP server for picoli.site — URL shortening and click analytics for AI agents.

Shorten URLs, track clicks, and analyze link performance directly from your AI assistant.

Setup

1. Get your API key

Create an account at picoli.site and get your API key from the dashboard.

2. Configure your MCP client

Claude Desktop / Claude Code

Add to your MCP configuration:

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

Add to .cursor/mcp.json:

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

Tools

shorten_url

Create a short URL with an optional custom slug.

Example prompts:

shorten_urls

Create multiple short URLs at once (up to 500).

Example prompts:

  • "Shorten these 3 URLs: ..."

get_link_stats

Get click statistics for specific links (bot traffic excluded).

Example prompts:

  • "How many clicks did my 'launch' link get?"
  • "Show me stats for these slugs: launch, demo, blog-post"

list_links

List all shortened URLs with click counts and pagination.

Example prompts:

  • "Show me all my short links"
  • "List my links sorted by clicks"

get_analytics

Get analytics overview: top 10 links, daily click trends, and totals.

Example prompts:

  • "Show me my link analytics for this week"
  • "What are my top performing links?"
  • "Give me click stats from 2026-01-01 to 2026-01-31"

Environment Variables

VariableRequiredDefaultDescription
PICOLI_API_KEYYes—Your picoli.site API key
PICOLI_BASE_URLNohttps://picoli.siteAPI base URL (for self-hosted instances)

Development

bash
git clone https://github.com/yun/picoli-mcp.gitcd picoli-mcpnpm installnpm run build

Test locally:

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

License

MIT

來源：README.md，提交 b20085a

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.1最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。