Dumpling AI MCP Server

Herramientas de extracción, conversión y raspado de datos de Dumpling AI.

Documentación

Dumpling AI MCP Server

Una implementación de servidor de Model Context Protocol (MCP) que se integra con Dumpling AI para extracción de datos, procesamiento de contenido, gestión de conocimiento, agentes de IA y capacidades de ejecución de código.

Características

Integración completa con todos los endpoints de la API de Dumpling AI
APIs de datos para transcripciones de YouTube, búsqueda, autocompletado, mapas, lugares, noticias y reseñas
Web scraping con soporte para scraping, rastreo, capturas de pantalla y extracción de datos estructurados
Herramientas de conversión de documentos para extracción de texto, operaciones con PDF y procesamiento de video
Extrae datos de documentos, imágenes, audio y video
Capacidades de IA que incluyen completaciones de agentes, gestión de bases de conocimiento y generación de imágenes
Herramientas de desarrollo para ejecutar código JavaScript y Python en un entorno seguro
Manejo automático de errores y formato detallado de respuestas

Instalación

Instalación mediante Smithery

Para instalar mcp-server-dumplingai para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @Dumpling-AI/mcp-server-dumplingai --client claude

Ejecución con npx

env DUMPLING_API_KEY=your_api_key npx -y mcp-server-dumplingai

Instalación manual

npm install -g mcp-server-dumplingai

Ejecución en Cursor

Configuración de Cursor 🖥️ Nota: Requiere Cursor versión 0.45.6+

Para configurar Dumpling AI MCP en Cursor:

Abre la configuración de Cursor
Ve a Features > MCP Servers
Haz clic en "+ Add New MCP Server"
Introduce lo siguiente:

{
  "mcpServers": {
    "dumplingai": {
      "command": "npx",
      "args": ["-y", "mcp-server-dumplingai"],
      "env": {
        "DUMPLING_API_KEY": "<your-api-key>"
      }
    }
  }
}

Si usas Windows y tienes problemas, prueba cmd /c "set DUMPLING_API_KEY=your-api-key && npx -y mcp-server-dumplingai"

Reemplaza your-api-key con tu clave de API de Dumpling AI.

Configuración

Variables de entorno

DUMPLING_API_KEY: Tu clave de API de Dumpling AI (obligatoria)

Herramientas disponibles

APIs de datos

1. Obtener transcripción de YouTube (`get-youtube-transcript`)

Extrae transcripciones de videos de YouTube con marcas de tiempo opcionales.

{
  "name": "get-youtube-transcript",
  "arguments": {
    "videoUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "includeTimestamps": true,
    "timestampsToCombine": 3,
    "preferredLanguage": "en"
  }
}

2. Búsqueda (`search`)

Realiza búsquedas web de Google y opcionalmente extrae contenido de los resultados.

{
  "name": "search",
  "arguments": {
    "query": "machine learning basics",
    "country": "us",
    "language": "en",
    "dateRange": "pastMonth",
    "scrapeResults": true,
    "numResultsToScrape": 3,
    "scrapeOptions": {
      "format": "markdown",
      "cleaned": true
    }
  }
}

3. Obtener autocompletado (`get-autocomplete`)

Obtén sugerencias de autocompletado de búsqueda de Google para una consulta.

{
  "name": "get-autocomplete",
  "arguments": {
    "query": "how to learn",
    "country": "us",
    "language": "en",
    "location": "New York"
  }
}

4. Buscar en Maps (`search-maps`)

Busca ubicaciones y negocios en Google Maps.

{
  "name": "search-maps",
  "arguments": {
    "query": "coffee shops",
    "gpsPositionZoom": "37.7749,-122.4194,14z",
    "language": "en",
    "page": 1
  }
}

5. Buscar lugares (`search-places`)

Busca lugares con información más detallada.

{
  "name": "search-places",
  "arguments": {
    "query": "hotels in paris",
    "country": "fr",
    "language": "en",
    "page": 1
  }
}

6. Buscar noticias (`search-news`)

Busca artículos de noticias con parámetros personalizables.

{
  "name": "search-news",
  "arguments": {
    "query": "climate change",
    "country": "us",
    "language": "en",
    "dateRange": "pastWeek"
  }
}

7. Obtener reseñas de Google (`get-google-reviews`)

Recupera reseñas de Google para negocios o lugares.

{
  "name": "get-google-reviews",
  "arguments": {
    "businessName": "Eiffel Tower",
    "location": "Paris, France",
    "limit": 10,
    "sortBy": "relevance"
  }
}

Web Scraping

8. Scrape (`scrape`)

Extrae contenido de una página web con opciones de formato.

{
  "name": "scrape",
  "arguments": {
    "url": "https://example.com",
    "format": "markdown",
    "cleaned": true,
    "renderJs": true
  }
}

9. Crawl (`crawl`)

Rastrea sitios web de forma recursiva y extrae contenido con parámetros personalizables.

{
  "name": "crawl",
  "arguments": {
    "baseUrl": "https://example.com",
    "maxPages": 10,
    "crawlBeyondBaseUrl": false,
    "depth": 2,
    "scrapeOptions": {
      "format": "markdown",
      "cleaned": true,
      "renderJs": true
    }
  }
}

10. Captura de pantalla (`screenshot`)

Captura pantallas de páginas web con opciones de viewport y formato personalizables.

{
  "name": "screenshot",
  "arguments": {
    "url": "https://example.com",
    "width": 1280,
    "height": 800,
    "fullPage": true,
    "format": "png",
    "waitFor": 1000
  }
}

11. Extraer (`extract`)

Extrae datos estructurados de páginas web mediante instrucciones impulsadas por IA.

{
  "name": "extract",
  "arguments": {
    "url": "https://example.com/products",
    "instructions": "Extract all product names, prices, and descriptions from this page",
    "schema": {
      "products": [
        {
          "name": "string",
          "price": "number",
          "description": "string"
        }
      ]
    },
    "renderJs": true
  }
}

Conversión de documentos

12. Doc a texto (`doc-to-text`)

Convierte documentos a texto plano con OCR opcional.

{
  "name": "doc-to-text",
  "arguments": {
    "url": "https://example.com/document.pdf",
    "options": {
      "ocr": true,
      "language": "en"
    }
  }
}

13. Convertir a PDF (`convert-to-pdf`)

Convierte varios formatos de archivo a PDF.

{
  "name": "convert-to-pdf",
  "arguments": {
    "url": "https://example.com/document.docx",
    "format": "docx",
    "options": {
      "quality": 90,
      "pageSize": "A4",
      "margin": 10
    }
  }
}

14. Combinar PDFs (`merge-pdfs`)

Combina varios PDF en un solo documento.

{
  "name": "merge-pdfs",
  "arguments": {
    "urls": ["https://example.com/doc1.pdf", "https://example.com/doc2.pdf"],
    "options": {
      "addPageNumbers": true,
      "addTableOfContents": true
    }
  }
}

15. Recortar video (`trim-video`)

Extrae un clip específico de un video.

{
  "name": "trim-video",
  "arguments": {
    "url": "https://example.com/video.mp4",
    "startTime": 30,
    "endTime": 60,
    "output": "mp4",
    "options": {
      "quality": 720,
      "fps": 30
    }
  }
}

16. Extraer documento (`extract-document`)

Extrae contenido específico de documentos en varios formatos.

{
  "name": "extract-document",
  "arguments": {
    "url": "https://example.com/document.pdf",
    "format": "structured",
    "options": {
      "ocr": true,
      "language": "en",
      "includeMetadata": true
    }
  }
}

17. Extraer imagen (`extract-image`)

Extrae texto e información de imágenes.

{
  "name": "extract-image",
  "arguments": {
    "url": "https://example.com/image.jpg",
    "extractionType": "text",
    "options": {
      "language": "en",
      "detectOrientation": true
    }
  }
}

18. Extraer audio (`extract-audio`)

Transcribe y extrae información de archivos de audio.

{
  "name": "extract-audio",
  "arguments": {
    "url": "https://example.com/audio.mp3",
    "language": "en",
    "options": {
      "model": "enhanced",
      "speakerDiarization": true,
      "wordTimestamps": true
    }
  }
}

19. Extraer video (`extract-video`)

Extrae contenido de videos, incluidas transcripciones, escenas y objetos.

{
  "name": "extract-video",
  "arguments": {
    "url": "https://example.com/video.mp4",
    "extractionType": "transcript",
    "options": {
      "language": "en",
      "speakerDiarization": true
    }
  }
}

20. Leer metadatos de PDF (`read-pdf-metadata`)

Extrae metadatos de archivos PDF.

{
  "name": "read-pdf-metadata",
  "arguments": {
    "url": "https://example.com/document.pdf",
    "includeExtended": true
  }
}

21. Escribir metadatos de PDF (`write-pdf-metadata`)

Actualiza metadatos en archivos PDF.

{
  "name": "write-pdf-metadata",
  "arguments": {
    "url": "https://example.com/document.pdf",
    "metadata": {
      "title": "New Title",
      "author": "John Doe",
      "keywords": ["keyword1", "keyword2"]
    }
  }
}

IA

22. Generar completación de agente (`generate-agent-completion`)

Obtén completaciones de agentes de IA con definiciones de herramientas opcionales.

{
  "name": "generate-agent-completion",
  "arguments": {
    "prompt": "How can I improve my website's SEO?",
    "model": "gpt-4",
    "temperature": 0.7,
    "maxTokens": 500,
    "context": ["The website is an e-commerce store selling handmade crafts."]
  }
}

23. Buscar en base de conocimiento (`search-knowledge-base`)

Busca información relevante en una base de conocimiento.

{
  "name": "search-knowledge-base",
  "arguments": {
    "kbId": "kb_12345",
    "query": "How to optimize database performance",
    "limit": 5,
    "similarityThreshold": 0.7
  }
}

24. Añadir a base de conocimiento (`add-to-knowledge-base`)

Añade entradas a una base de conocimiento.

{
  "name": "add-to-knowledge-base",
  "arguments": {
    "kbId": "kb_12345",
    "entries": [
      {
        "text": "MongoDB is a document-based NoSQL database.",
        "metadata": {
          "source": "MongoDB documentation",
          "category": "databases"
        }
      }
    ],
    "upsert": true
  }
}

25. Generar imagen con IA (`generate-ai-image`)

Genera imágenes usando modelos de IA.

{
  "name": "generate-ai-image",
  "arguments": {
    "prompt": "A futuristic city with flying cars and neon lights",
    "width": 1024,
    "height": 1024,
    "numImages": 1,
    "quality": "hd",
    "style": "photorealistic"
  }
}

26. Generar imagen (`generate-image`)

Genera imágenes usando varios proveedores de IA.

{
  "name": "generate-image",
  "arguments": {
    "prompt": "A golden retriever in a meadow of wildflowers",
    "provider": "dalle",
    "width": 1024,
    "height": 1024,
    "numImages": 1
  }
}

Herramientas de desarrollo

27. Ejecutar código JavaScript (`run-js-code`)

Ejecuta código JavaScript con dependencias opcionales.

{
  "name": "run-js-code",
  "arguments": {
    "code": "const result = [1, 2, 3, 4].reduce((sum, num) => sum + num, 0); console.log(`Sum: ${result}`); return result;",
    "dependencies": {
      "lodash": "^4.17.21"
    },
    "timeout": 5000
  }
}

28. Ejecutar código Python (`run-python-code`)

Ejecuta código Python con dependencias opcionales.

{
  "name": "run-python-code",
  "arguments": {
    "code": "import numpy as np\narr = np.array([1, 2, 3, 4, 5])\nmean = np.mean(arr)\nprint(f'Mean: {mean}')\nreturn mean",
    "dependencies": ["numpy", "pandas"],
    "timeout": 10000,
    "saveOutputFiles": true
  }
}

Manejo de errores

El servidor proporciona un manejo robusto de errores:

Mensajes de error detallados con códigos de estado HTTP
Validación de clave de API
Validación de entrada mediante esquemas de Zod
Manejo de errores de red con mensajes descriptivos

Ejemplo de respuesta de error:

{
  "content": [
    {
      "type": "text",
      "text": "Error: Failed to fetch YouTube transcript: 404 Not Found"
    }
  ],
  "isError": true
}

Desarrollo

# Install dependencies
npm install

# Build
npm run build

Licencia

Licencia MIT: consulta el archivo LICENSE para más detalles

Dumpling AI MCP Server

Documentación