使用说明
项目简介
dubco-mcp-server-npm 是一个基于 Model Context Protocol (MCP) 构建的服务器,它作为一个桥梁,连接 AI 助手和 Dub.co 短链接服务。通过此服务器,AI 助手可以方便地调用 Dub.co API,实现短链接的创建、更新和删除等操作。
主要功能点
- 创建短链接 (create_link): 允许 AI 助手为指定的 URL 创建 Dub.co 短链接,可以自定义短链接的域名和别名。
- 更新短链接 (update_link): 允许 AI 助手更新已有的 Dub.co 短链接的目标 URL 或域名等信息。
- 删除短链接 (delete_link): 允许 AI 助手删除指定的 Dub.co 短链接。
- 基于 MCP 协议: 遵循 Model Context Protocol 标准,易于与支持 MCP 协议的 AI 客户端集成。
- 使用 Dub.co API: 通过官方 Dub.co API 进行操作,功能可靠。
安装步骤
- 安装 Node.js: 确保你的系统已安装 Node.js (版本 16.0.0 或更高)。
- 全局安装 (推荐): 打开终端,运行以下命令全局安装 'dubco-mcp-server':
或者 本地安装: 在你的项目目录下运行:npm install -g dubco-mcp-servernpm install dubco-mcp-server
服务器配置 (MCP 客户端配置)
要将 'dubco-mcp-server' 集成到 MCP 客户端(例如 Cursor IDE),你需要配置 MCP 服务器信息。以下是一个典型的 JSON 格式配置示例,你需要将其添加到你的 MCP 客户端配置中。
{ "mcpServers": { "dubco": { // 服务器名称,可以自定义 "command": "npx", // 启动命令,通常为 npx 或 node "args": ["-y", "dubco-mcp-server"], // 命令参数,这里使用 npx 运行 dubco-mcp-server "env": { "DUBCO_API_KEY": "YOUR_DUBCO_API_KEY" // 环境变量,替换为你的 Dub.co API 密钥 }, "disabled": false, // 设置为 false 启用该服务器 "autoApprove": [] // 自动批准的工具列表,默认为空 } } }
配置说明:
- '"dubco"': MCP 服务器的名称,可以自定义,用于在客户端中标识该服务器。
- '"command": "npx"': 指定用于启动服务器的命令。 'npx' 可以方便地运行本地或全局安装的 npm 包。如果全局安装后 'dubco-mcp-server' 命令可以直接使用,也可以将 '"command"' 设置为 '"dubco-mcp-server"',并移除 '"args"' 字段。
- '"args": ["-y", "dubco-mcp-server"]': 'npx' 命令的参数。 '"-y"' 标志表示自动确认执行, '"dubco-mcp-server"' 是要运行的 npm 包名。
- '"env": { "DUBCO_API_KEY": "YOUR_DUBCO_API_KEY" }': 设置环境变量。 务必将 '"YOUR_DUBCO_API_KEY"' 替换为你从 Dub.co 仪表板获取的 API 密钥。 API 密钥是访问 Dub.co API 的凭证,必须正确配置。
- '"disabled": false': 设置为 'false' 表示启用该 MCP 服务器。设置为 'true' 则禁用。
- '"autoApprove": []': 用于配置自动批准执行的工具列表。当前为空,表示所有工具调用都需要用户手动批准。
获取 Dub.co API 密钥:
- 访问 Dub.co dashboard 并登录你的 Dub.co 账户。
- 在 API 设置页面,创建或复制你的 API 密钥。
- 将 API 密钥替换到上述 JSON 配置中的 '"YOUR_DUBCO_API_KEY"' 位置。
基本使用方法
- 启动 MCP 客户端: 打开并配置支持 MCP 协议的 AI 客户端,例如 Cursor IDE。
- 添加 MCP 服务器配置: 将上述 JSON 配置添加到你的 MCP 客户端的服务器配置中。确保配置中的 'DUBCO_API_KEY' 已正确替换为你的 API 密钥。
- 在 AI 助手中使用工具: 在 AI 客户端的对话或编辑器中,指示 AI 助手使用 'dubco-mcp-server' 提供的工具,例如:
- "请创建一个 Dub.co 短链接,目标 URL 是 https://example.com" (触发 'create_link' 工具)
- "更新 ID 为 clxyz123 的短链接,新的目标 URL 是 https://new.example.com" (触发 'update_link' 工具)
- "删除 ID 为 abcdefg 的短链接" (触发 'delete_link' 工具)
- 确认工具使用: 当 AI 助手尝试使用工具时,MCP 客户端通常会提示你确认是否允许执行该操作。根据需要批准工具的使用。
- 查看结果: 工具执行成功后,AI 助手会在对话中返回操作结果,例如创建的短链接信息或更新成功的提示。
注意: 该服务器是非官方的,由社区开发者创建。使用时请注意安全风险,并确保你的 Dub.co API 密钥安全保管。
信息
分类
网页与API