Dub.co Short Links (Unofficial)

Um servidor MCP não oficial para criar e gerenciar links curtos com o Dub.co.

GitHub
7

Documentação

Servidor dubco-mcp-server não oficial

npm version License: ISC Node.js Version smithery badge

Um servidor Model Context Protocol (MCP) para criar e gerenciar links curtos do Dub.co (não oficial). Este servidor permite que assistentes de IA criem, atualizem e excluam links curtos por meio da API do Dub.co.

Unofficial dubco-mcp-server MCP server

🚀 Recursos

  • Crie links curtos personalizados com seus domínios do Dub.co
  • Atualize links curtos existentes
  • Exclua links curtos
  • Integração perfeita com assistentes de IA por meio do Model Context Protocol

📋 Pré-requisitos

  • Node.js 16.0.0 ou superior
  • Uma conta Dub.co com acesso à API
  • Uma chave de API do painel do Dub.co

💻 Instalação

Instalação via Smithery

Para instalar o Dub.co MCP Server para Claude Desktop automaticamente via Smithery:

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

Instalação Global

npm install -g dubco-mcp-server

Instalação Local

npm install dubco-mcp-server

Uso Direto com npx

npx dubco-mcp-server

⚙️ Configuração

Este servidor MCP requer uma chave de API do Dub.co para funcionar. Você pode obter sua chave de API no painel do Dub.co.

Defina a chave de API como uma variável de ambiente:

export DUBCO_API_KEY=your_api_key_here

Para configuração persistente, adicione isso ao seu perfil de shell (por exemplo, .bashrc, .zshrc):

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

🖥️ Configuração no Cursor IDE

O Cursor IDE oferece suporte nativo a servidores MCP. Siga estas etapas para configurar o dubco-mcp-server no Cursor:

Etapa 1: Instalar o Cursor IDE

Se ainda não o fez, baixe e instale o Cursor IDE (versão 0.4.5.9 ou posterior).

Etapa 2: Abrir as Configurações do Cursor

  1. Abra o Cursor IDE
  2. Clique no ícone de engrenagem no canto inferior esquerdo, ou use o atalho de teclado Cmd+, (Mac) ou Ctrl+, (Windows/Linux)
  3. Navegue até a seção Features
  4. Role para baixo até encontrar a seção "MCP Servers"

Etapa 3: Adicionar o Servidor MCP

  1. Clique em "+ Add new MCP server"
  2. No diálogo que aparecer:
    • Nome: Digite "Dub.co MCP Server" (ou qualquer nome de sua preferência)
    • Tipo: Selecione "command" no menu suspenso
    • Comando: Digite env DUBCO_API_KEY=your_api_key_here npx -y dubco-mcp-server (Substitua your_api_key_here pela sua chave de API real do Dub.co)
  3. Clique em "Save" para adicionar o servidor

Etapa 4: Verificar a Conexão

Após adicionar o servidor MCP, você deve ver um indicador de status verde ao lado do nome do servidor. Se aparecer um status vermelho ou amarelo, tente:

  1. Verificar se sua chave de API está correta
  2. Reiniciar o Cursor IDE
  3. Verificar se o Node.js (16.0.0+) está instalado corretamente

Etapa 5: Usar o Servidor

O dubco-mcp-server fornece ferramentas que podem ser usadas com os recursos de IA do Cursor:

  1. Abra o modo Composer ou Agent do Cursor (o MCP só funciona nesses modos)
  2. Instrua explicitamente a IA a usar as ferramentas do Dub.co (create_link, update_link, delete_link)
  3. Aceite os prompts de uso de ferramentas quando eles aparecerem

🔧 Uso com MCP

Este servidor fornece ferramentas que podem ser usadas por assistentes de IA por meio do Model Context Protocol. Para usá-lo com um assistente de IA compatível com MCP, adicione-o à sua configuração MCP.

Exemplo de Configuração MCP

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

Ferramentas Disponíveis

create_link

Crie um novo link curto no Dub.co.

Parâmetros:

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

Exemplo:

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

update_link

Atualize um link curto existente no Dub.co.

Parâmetros:

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

Exemplo:

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

delete_link

Exclua um link curto no Dub.co.

Parâmetros:

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

Exemplo:

{
  "linkId": "clwxyz123456"
}

🔍 Como Funciona

O servidor se conecta à API do Dub.co usando sua chave de API e fornece uma interface padronizada para assistentes de IA interagirem com o Dub.co por meio do Model Context Protocol. Quando uma ferramenta é chamada:

  1. O servidor valida os parâmetros de entrada
  2. Ele envia a solicitação apropriada para a API do Dub.co
  3. Ele processa a resposta e a retorna em um formato que o assistente de IA possa entender

🛠️ Desenvolvimento

Compilando a partir do Código-Fonte

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

Executando em Modo de Desenvolvimento

npm run dev

📝 Licença

Este projeto é licenciado sob a Licença ISC - consulte o arquivo LICENSE para obter detalhes.

🔗 Links

👥 Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

  1. Faça um fork do repositório
  2. Crie sua branch de recurso (git checkout -b feature/amazing-feature)
  3. Faça commit das suas alterações (git commit -m 'Add some amazing feature')
  4. Envie para a branch (git push origin feature/amazing-feature)
  5. Abra um Pull Request

👨‍💻 Criado Por

Este servidor Dub.co MCP não oficial foi criado por GitMaxd (@gitmaxd no X).

Este projeto foi desenvolvido como um exercício de aprendizado para entender o Model Context Protocol e como construir servidores MCP. Escolhi o Dub.co como alvo de integração por causa de sua API simples e utilidade prática, tornando-o um candidato ideal para um projeto de aprendizado.

Embora eu não tenha afiliação oficial com o Dub.co, recomendo fortemente o serviço deles para criação de links curtos, tanto manual quanto automatizada. A API deles é bem documentada e fácil de trabalhar, tornando-a perfeita para esse tipo de integração.

Se você achar este projeto útil ou tiver sugestões de melhorias, sinta-se à vontade para entrar em contato ou contribuir com o repositório. Feliz encurtamento de links!