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 许可证。