clypt

Clypt MCP 服务

一个MCP（Model Context Protocol）服务，可将 AI 助手连接到 Clypt——AI 驱动的链接智能平台。直接通过 Claude、ChatGPT、Cursor 或任何兼容 MCP 的客户端缩短链接、查看分析数据、管理标签和文件夹。

快速开始

npx clypt-mcp

你需要一个 Clypt API 密钥。请在 clypt.io/dashboard/settings 获取。

安装

Claude Desktop

将以下内容添加到 Claude Desktop 配置文件中（macOS 上的路径为 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "clypt": {
      "command": "npx",
      "args": ["-y", "clypt-mcp"],
      "env": {
        "CLYPT_API_KEY": "clypt_your_key_here"
      }
    }
  }
}

Cursor

将以下内容添加到 Cursor MCP 设置（.cursor/mcp.json）中：

{
  "mcpServers": {
    "clypt": {
      "command": "npx",
      "args": ["-y", "clypt-mcp"],
      "env": {
        "CLYPT_API_KEY": "clypt_your_key_here"
      }
    }
  }
}

全局安装

npm install -g clypt-mcp
CLYPT_API_KEY=clypt_your_key_here clypt-mcp

环境变量

变量	必填	默认值	说明
CLYPT_API_KEY	是	-	你的 Clypt API 密钥
CLYPT_BASE_URL	否	https://clypt.io	自定义 API 基础 URL

可用工具

shorten_link

创建一个缩短后的 Clypt 链接。

• url（必填）— 要缩短的 URL
• slug — 自定义短代码
• tags — 要添加的标签
• expiresAt — 过期日期（ISO 8601）
• password — 密码保护
• folderId — 用于整理的文件夹

list_links

列出你的缩短链接，并支持搜索和筛选。

• search — 按 URL、标题或短代码搜索
• tag — 按标签筛选
• limit — 每页结果数（最多 100）
• offset — 分页偏移量

get_link_analytics

获取特定链接的点击分析数据。

• linkId（必填）— 链接 ID 或短代码
• period — 时间范围：7d、30d、90d 或 all

get_dashboard_stats

获取概览仪表板统计数据（链接总数、点击次数、表现最佳的链接）。无需参数。

generate_qr_code

为任意 URL 生成二维码。

• url（必填）— 要编码的 URL
• size — 尺寸（像素，100-1000）
• fgColor — 前景色十六进制代码
• bgColor — 背景色十六进制代码

manage_tags

创建或列出标签。

• action（必填）— create 或 list
• name — 标签名称（用于创建）
• color — 标签颜色十六进制代码（用于创建）

manage_folders

创建或列出文件夹。

• action（必填）— create 或 list
• name — 文件夹名称（用于创建）
• parentId — 父文件夹 ID（用于创建）

bulk_shorten

一次缩短多个 URL（最多 25 个）。

• urls（必填）— URL 数组
• tags — 应用于所有链接的标签
• folderId — 用于所有链接的文件夹

delete_link

按 ID 删除链接。

• linkId（必填）— 要删除的链接 ID

create_ab_test

为链接创建 A/B 拆分测试（Pro 方案或更高版本）。

• linkId（必填）— 要测试的链接 ID
• variants（必填）— 包含 2–5 个变体的数组，每个变体包含 url、可选的 label 和 weight（权重总和必须为 100）

get_ab_test_results

获取 A/B 测试结果，包括各变体的点击次数、统计显著性（卡方检验）和胜出方案建议。

• linkId（必填）— 链接 ID

end_ab_test

结束正在进行的 A/B 测试。链接将恢复为原始 URL。测试数据会保留。

• linkId（必填）— 链接 ID

promote_ab_test_winner

将胜出变体设为唯一目标 URL，并结束测试。

• linkId（必填）— 链接 ID
• variantId（必填）— 要设为胜出方案的变体 ID

generate_ai_qr_code

使用 Stable Diffusion + ControlNet 生成 AI 艺术二维码（Pro 方案或更高版本）。

• linkId（必填）— 要为其生成二维码的链接 ID
• prompt — 描述所需艺术风格的文本提示词
• style — 预设风格：watercolor、oil_painting、cyberpunk、minimal、japanese、nature、abstract、geometric

示例用法

配置完成后，你可以向 AI 助手提出如下请求：

"用标签 'marketing' 缩短 https://example.com/my-long-article-url"

"显示我本月最热门链接的分析数据"

"为 clypt.io/abc123 创建二维码"

"列出我所有带有标签 'campaign-q1' 的链接"

"为我们的新闻简报批量缩短这 5 个 URL"

"为我的着陆页链接设置 50/50 A/B 测试，对比新设计和旧设计"

"查看 A/B 测试结果——现在有胜出版本了吗？"

"推广胜出版本并结束测试"

开发

git clone https://github.com/Bonsai-Tech-LLC/clypt-mcp.git
cd clypt-mcp
npm install
npm run build
CLYPT_API_KEY=your_key node dist/index.js

许可证

MIT - 详情请参阅 LICENSE。

链接

• Clypt — AI 驱动的链接智能
• Clypt API 文档
• MCP 协议
• 报告问题