mcpField
P
Picoli Mcp

Picoli Mcp

本地服务
github.com/amaterous数据与分析237 周前更新
代码仓库

关于 Picoli Mcp

Picoli Mcp 是用于管理 picoli.site 短链接和点击分析的 MCP 服务。AI 助手可借此创建链接、查看统计数据并了解链接表现。

主要功能

  1. 01创建带自定义标识的短链接
  2. 02一次缩短最多 500 个 URL
  3. 03查看指定链接的点击统计
  4. 04分页列出链接及点击数
  5. 05查看热门链接、趋势和总量

适用场景

  1. 01为营销活动创建品牌短链接
  2. 02为内容发布批量缩短 URL
  3. 03检查指定链接的点击数
  4. 04查看每日链接表现

MCP 相关

向 MCP 客户端提供 URL 缩短和分析工具。服务需要 picoli.site API 密钥，并支持配置 API 基础 URL。

#url-shortener#analytics#link-management

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "amaterous-picoli": {
      "command": "npx",
      "args": [
        "-y",
        "picoli-mcp"
      ]
    }
  }
}
启动命令npx -y picoli-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmpicoli-mcp1.0.1

工具

5

收录的工具列表 · 更新于 2 周前

参数类型必填说明
urlstring是要缩短的目标 URL
slugstring否可选的自定义 slug（例如 'my-link'）。如果未提供，则会生成随机 slug。

详细介绍

picoli-mcp

picoli.site 的 MCP 服务——为 AI Agent 提供 URL 缩短和点击分析功能。

直接通过 AI 助手缩短 URL、跟踪点击量并分析链接效果。

设置

1. 获取 API 密钥

在 picoli.site 创建账户，并从控制面板获取 API 密钥。

2. 配置 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，可选择自定义别名。

示例提示词：

shorten_urls

一次创建多个短 URL（最多 500 个）。

示例提示词：

  • “缩短以下 3 个 URL：……”
get_link_stats

获取指定链接的点击统计信息（不包括机器人流量）。

示例提示词：

  • “我的 ‘launch’ 链接获得了多少次点击？”
  • “显示这些别名的统计信息：launch、demo、blog-post”
list_links

列出所有已缩短的 URL，并显示点击次数和分页信息。

示例提示词：

  • “显示我的所有短链接”
  • “按点击次数排序列出我的链接”
get_analytics

获取分析概览：点击次数排名前 10 的链接、每日点击趋势和总数。

示例提示词：

  • “显示我本周的链接分析”
  • “哪些链接的表现最好？”
  • “提供 2026-01-01 至 2026-01-31 的点击统计信息”

环境变量

变量必填默认值描述
PICOLI_API_KEY是—你的 picoli.site API 密钥
PICOLI_BASE_URL否https://picoli.siteAPI 基础 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

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。