返回市场
Dubco-MCP服务器-npm

Dubco-MCP服务器-npm

作者:Gitmaxd6 星标更新:2025-04-16

项目介绍

Unofficial dubco-mcp-server

npm 版本 许可证: ISC Node.js 版本 smithery 徽章

这是一个用于创建和管理 Dub.co 短链接的非官方 Model Context Protocol (MCP) 服务器。此服务器使AI助手能够通过Dub.co API创建、更新和删除短链接。

<a href="https://glama.ai/mcp/servers/0tvsbwmk8m"> <img width="380" height="200" src="https://gips0.baidu.com/it/u=959574707,711786599&fm=3081&app=3081&f=PNG?w=760&h=400" alt="非官方 dubco-mcp-server MCP 服务器" /> </a>

🚀 功能

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

📋 先决条件

  • Node.js 16.0.0 或更高版本
  • 具有API访问权限的Dub.co账户
  • Dub.co仪表板获取的API密钥

💻 安装

通过Smithery安装

要通过Smithery自动安装Dub.co MCP服务器:

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. 导航到“功能”部分
  4. 向下滚动找到“MCP服务器”部分

步骤3:添加MCP服务器

  1. 单击“+ 添加新MCP服务器”
  2. 在出现的对话框中:
    • 名称:输入“Dub.co MCP服务器”(或您喜欢的任何名称)
    • 类型:从下拉菜单中选择“command”
    • 命令:输入env DUBCO_API_KEY=your_api_key_here npx -y dubco-mcp-server (将your_api_key_here替换为您实际的Dub.co API密钥)
  3. 单击“保存”以添加服务器

步骤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助手提供了一个标准化接口,以便通过模型上下文协议与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文件。

🔗 链接

👥 贡献

欢迎贡献!请随时提交Pull Request。

  1. 分叉仓库
  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@gitmaxd在X上)创建的。

该项目作为一个学习练习开发,目的是了解模型上下文协议以及如何构建MCP服务器。我选择了Dub.co作为集成目标,因为其API简单明了且实用性强,使其成为学习项目的理想候选。

虽然我没有与Dub.co的正式关联,但我强烈推荐他们的服务,无论是手动还是自动化创建短链接。他们的API文档齐全且易于使用,非常适合这种类型的集成。

如果您发现这个项目有用或有任何改进建议,请随时联系或为仓库做出贡献。祝您缩短链接愉快!