JinDaGe - picoli-mcp MCP Details

article

README

🚀 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 日的点击统计信息"

📚 详细文档

环境变量

| 属性 | 详情 | |------|------| | 是否必需 | PICOLI_API_KEY 是必需的，PICOLI_BASE_URL 不是必需的 | | 默认值 | PICOLI_API_KEY 无默认值，PICOLI_BASE_URL 默认是 https://picoli.site | | 描述 | PICOLI_API_KEY 是你在 picoli.site 的 API 密钥；PICOLI_BASE_URL 是 API 的基础 URL（用于自托管实例） |

📦 安装指南

开发环境搭建

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

picoli-mcp