Unofficial dubco-mcp-server

Unofficial dubco-mcp-server

用于创建和管理 Dub.co 短链接的模型上下文协议（MCP）服务（非官方）。此服务可让 AI 助手通过 Dub.co API 创建、更新和删除短链接。

🚀 功能

• 使用你的 Dub.co 域名创建自定义短链接
• 更新现有短链接
• 删除短链接
• 通过模型上下文协议与 AI 助手无缝集成

📋 前提条件

• Node.js 16.0.0 或更高版本
• 拥有 API 访问权限的 Dub.co 账户
• 从 Dub.co 控制面板 获取的 API 密钥

💻 安装

通过 Smithery 安装

如需通过 Smithery 自动为 Claude Desktop 安装 Dub.co MCP Server：

npx -y @smithery/cli install @Gitmaxd/dubco-mcp-server-npm --client claude

全局安装

npm install -g dubco-mcp-server

本地安装

npm install dubco-mcp-server

使用 npx 直接运行

npx dubco-mcp-server

⚙️ 配置

此 MCP 服务需要 Dub.co API 密钥才能运行。你可以从 Dub.co 控制面板 获取 API 密钥。

将 API 密钥设置为环境变量：

export DUBCO_API_KEY=your_api_key_here

如需持久配置，请将以下内容添加到 shell 配置文件中（例如 .bashrc、.zshrc）：

echo 'export DUBCO_API_KEY=your_api_key_here' >> ~/.zshrc

🖥️ Cursor IDE 设置

Cursor IDE 原生支持 MCP 服务。按照以下步骤在 Cursor 中设置 dubco-mcp-server：

步骤 1：安装 Cursor IDE

如果你尚未安装，请下载并安装 Cursor IDE（版本 0.4.5.9 或更高版本）。

步骤 2：打开 Cursor 设置

1. 打开 Cursor IDE
2. 点击左下角的齿轮图标，或使用键盘快捷键 Cmd+,（Mac）或 Ctrl+,（Windows/Linux）
3. 前往 Features 部分
4. 向下滚动，找到“MCP Servers”部分

步骤 3：添加 MCP 服务

1. 点击“+ Add new MCP server”
2. 在弹出的对话框中：
   • 名称：输入“Dub.co MCP Server”（或你喜欢的名称）
   • 类型：从下拉菜单中选择“command”
   • 命令：输入 env DUBCO_API_KEY=your_api_key_here npx -y dubco-mcp-server （将 your_api_key_here 替换为你的实际 Dub.co API 密钥）
3. 点击“Save”添加服务

步骤 4：验证连接

添加 MCP 服务后，你应该会在服务名称旁看到绿色状态指示灯。如果显示红色或黄色状态，请尝试：

1. 检查 API 密钥是否正确
2. 重启 Cursor IDE
3. 确认已正确安装 Node.js（16.0.0+）

步骤 5：使用服务

dubco-mcp-server 提供可与 Cursor AI 功能配合使用的工具：

1. 打开 Cursor 的 Composer 或 Agent 模式（MCP 仅在这些模式下有效）
2. 明确指示 AI 使用 Dub.co 工具（create_link、update_link、delete_link）
3. 出现工具使用提示时予以确认

🔧 通过 MCP 使用

此服务提供可供 AI 助手通过模型上下文协议使用的工具。若要与兼容 MCP 的 AI 助手搭配使用，请将其添加到 MCP 配置中。

MCP 配置示例

{
  "mcpServers": {
    "dubco": {
      "command": "npx",
      "args": ["-y", "dubco-mcp-server"],
      "env": {
        "DUBCO_API_KEY": "your_api_key_here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

可用工具

create_link

在 Dub.co 上创建新的短链接。

参数：

{
  "url": "https://example.com",
  "key": "optional-custom-slug",
  "externalId": "optional-external-id",
  "domain": "optional-domain-slug"
}

示例：

{
  "url": "https://github.com/gitmaxd/dubco-mcp-server-npm",
  "key": "dubco-mcp"
}

update_link

更新 Dub.co 上的现有短链接。

参数：

{
  "linkId": "link-id-to-update",
  "url": "https://new-destination.com",
  "domain": "new-domain-slug",
  "key": "new-custom-slug"
}

示例：

{
  "linkId": "clwxyz123456",
  "url": "https://github.com/gitmaxd/dubco-mcp-server-npm/releases"
}

delete_link

删除 Dub.co 上的短链接。

参数：

{
  "linkId": "link-id-to-delete"
}

示例：

{
  "linkId": "clwxyz123456"
}

🔍 工作原理

服务使用你的 API 密钥连接到 Dub.co API，并提供标准化接口，让 AI 助手通过 Model Context Protocol 与 Dub.co 交互。调用工具时：

1. 服务会验证输入参数
2. 服务会向 Dub.co API 发送相应请求
3. 服务会处理响应，并以 AI 助手能够理解的格式返回

🛠️ 开发

从源代码构建

git clone https://github.com/gitmaxd/dubco-mcp-server-npm.git
cd dubco-mcp-server-npm
npm install
npm run build

在开发模式下运行

npm run dev

📝 许可证

本项目采用 ISC 许可证授权，详情请参阅 LICENSE 文件。

🔗 链接

• Dub.co - URL 缩短服务
• Dub.co API 文档
• Model Context Protocol - 了解更多关于 MCP 的信息

👥 贡献

欢迎贡献！欢迎提交 Pull Request。

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 将分支推送到远程仓库（git push origin feature/amazing-feature）
5. 提交 Pull Request

👨‍💻 创建者

这个非官方的 Dub.co MCP 服务由 GitMaxd（X 上的 @gitmaxd）创建。

本项目是一个学习练习，旨在了解 Model Context Protocol 以及如何构建 MCP 服务。我选择 Dub.co 作为集成目标，是因为它的 API 简单明了且实用，是学习项目的理想选择。

虽然我与 Dub.co 没有官方关联，但我强烈推荐他们的服务，用于手动和自动创建短链接。他们的 API 文档完善、易于使用，非常适合此类集成。

如果你觉得这个项目有帮助，或对改进有任何建议，欢迎联系我或为仓库做出贡献。祝你链接缩短愉快！