Dub.co Short Links (Unofficial)

Un servidor MCP no oficial para crear y gestionar enlaces cortos con Dub.co.

Documentación

Servidor dubco-mcp-server no oficial

Un servidor de Protocolo de Contexto de Modelo (MCP) para crear y gestionar enlaces cortos de Dub.co (no oficial). Este servidor permite a los asistentes de IA crear, actualizar y eliminar enlaces cortos a través de la API de Dub.co.

🚀 Características

Crea enlaces cortos personalizados con tus dominios de Dub.co
Actualiza enlaces cortos existentes
Elimina enlaces cortos
Integración perfecta con asistentes de IA a través del Protocolo de Contexto de Modelo

📋 Requisitos previos

Node.js 16.0.0 o superior
Una cuenta de Dub.co con acceso a la API
Una clave de API desde el panel de Dub.co

💻 Instalación

Instalación mediante Smithery

Para instalar automáticamente el Servidor MCP de Dub.co para Claude Desktop a través de Smithery:

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

Instalación global

npm install -g dubco-mcp-server

Instalación local

npm install dubco-mcp-server

Uso directo con npx

npx dubco-mcp-server

⚙️ Configuración

Este servidor MCP requiere una clave de API de Dub.co para funcionar. Puedes obtener tu clave de API desde el panel de Dub.co.

Configura la clave de API como una variable de entorno:

export DUBCO_API_KEY=your_api_key_here

Para una configuración persistente, añade esto a tu perfil de shell (por ejemplo, .bashrc, .zshrc):

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

🖥️ Configuración del IDE Cursor

Cursor IDE proporciona soporte nativo para servidores MCP. Sigue estos pasos para configurar el dubco-mcp-server en Cursor:

Paso 1: Instalar Cursor IDE

Si aún no lo has hecho, descarga e instala Cursor IDE (versión 0.4.5.9 o posterior).

Paso 2: Abrir la configuración de Cursor

Abre Cursor IDE
Haz clic en el icono de engranaje en la esquina inferior izquierda, o usa el atajo de teclado Cmd+, (Mac) o Ctrl+, (Windows/Linux)
Navega a la sección de Funciones
Desplázate hacia abajo para encontrar la sección "Servidores MCP"

Paso 3: Añadir el servidor MCP

Haz clic en "+ Añadir nuevo servidor MCP"
En el diálogo que aparece:
- Nombre: Introduce "Servidor MCP de Dub.co" (o cualquier nombre que prefieras)
- Tipo: Selecciona "comando" en el menú desplegable
- Comando: Introduce env DUBCO_API_KEY=your_api_key_here npx -y dubco-mcp-server (Reemplaza your_api_key_here con tu clave de API real de Dub.co)
Haz clic en "Guardar" para añadir el servidor

Paso 4: Verificar la conexión

Después de añadir el servidor MCP, deberías ver un indicador de estado verde junto al nombre del servidor. Si muestra un estado rojo o amarillo, intenta:

Comprobar que tu clave de API es correcta
Reiniciar Cursor IDE
Verificar que Node.js (16.0.0+) está instalado correctamente

Paso 5: Usar el servidor

El dubco-mcp-server proporciona herramientas que se pueden usar con las funciones de IA de Cursor:

Abre el modo Composer o Agente de Cursor (MCP solo funciona en estos modos)
Indica explícitamente a la IA que use las herramientas de Dub.co (create_link, update_link, delete_link)
Acepta las solicitudes de uso de herramientas cuando aparezcan

🔧 Uso con MCP

Este servidor proporciona herramientas que pueden ser utilizadas por asistentes de IA a través del Protocolo de Contexto de Modelo. Para usarlo con un asistente de IA compatible con MCP, añádelo a tu configuración de MCP.

Ejemplo de configuración de MCP

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

Herramientas disponibles

create_link

Crea un nuevo enlace corto en Dub.co.

Parámetros:

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

Ejemplo:

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

update_link

Actualiza un enlace corto existente en Dub.co.

Parámetros:

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

Ejemplo:

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

delete_link

Elimina un enlace corto en Dub.co.

Parámetros:

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

Ejemplo:

{
  "linkId": "clwxyz123456"
}

🔍 Cómo funciona

El servidor se conecta a la API de Dub.co usando tu clave de API y proporciona una interfaz estandarizada para que los asistentes de IA interactúen con Dub.co a través del Protocolo de Contexto de Modelo. Cuando se llama a una herramienta:

El servidor valida los parámetros de entrada
Envía la solicitud adecuada a la API de Dub.co
Procesa la respuesta y la devuelve en un formato que el asistente de IA pueda entender

🛠️ Desarrollo

Compilar desde el código fuente

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

Ejecutar en modo de desarrollo

npm run dev

📝 Licencia

Este proyecto está licenciado bajo la Licencia ISC: consulta el archivo LICENCIA para más detalles.

🔗 Enlaces

Dub.co - El servicio de acortador de URLs
Documentación de la API de Dub.co
Protocolo de Contexto de Modelo - Aprende más sobre MCP

👥 Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una Solicitud de Extracción (Pull Request).

Haz un fork del repositorio
Crea tu rama de características (git checkout -b feature/amazing-feature)
Haz commit de tus cambios (git commit -m 'Add some amazing feature')
Sube a la rama (git push origin feature/amazing-feature)
Abre una Solicitud de Extracción

👨‍💻 Creado por

Este servidor MCP no oficial de Dub.co fue creado por GitMaxd (@gitmaxd en X).

Este proyecto se desarrolló como un ejercicio de aprendizaje para entender el Protocolo de Contexto de Modelo y cómo construir servidores MCP. Elegí Dub.co como objetivo de integración debido a su API sencilla y utilidad práctica, lo que lo convierte en un candidato ideal para un proyecto de aprendizaje.

Aunque no tengo afiliación oficial con Dub.co, recomiendo encarecidamente su servicio tanto para la creación manual como automatizada de enlaces cortos. Su API está bien documentada y es fácil de trabajar con ella, lo que la hace perfecta para este tipo de integración.

Si encuentras útil este proyecto o tienes sugerencias de mejora, no dudes en contactarme o contribuir al repositorio. ¡Feliz acortamiento de enlaces!