Servidor MCP de Dumpling AI
Una implementación de servidor de Protocolo de contexto de modelo (MCP) que se integra con Dumpling AI para la extracción de datos, el procesamiento de contenido, la gestión del conocimiento, los agentes de IA y las capacidades de ejecución de código.
Características
- Integración completa con todos los puntos finales de la API de Dumpling AI
- API 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 vídeo.
- Extraer datos de documentos, imágenes, audio y vídeo.
- Capacidades de IA que incluyen finalizaciones de agentes, gestión de bases de conocimiento y generación de imágenes
- Herramientas para desarrolladores para ejecutar código JavaScript y Python en un entorno seguro
- Manejo automático de errores y formato de respuesta detallado
Instalación
Para instalar mcp-server-dumplingai para Claude Desktop automáticamente a través de Smithery :
npx -y @smithery/cli install @Dumpling-AI/mcp-server-dumplingai --client claude
Ejecutando con npx
env DUMPLING_API_KEY=your_api_key npx -y mcp-server-dumplingai
Instalación manual
npm install -g mcp-server-dumplingai
Ejecutando en el cursor
Configuración del cursor 🖥️ Nota: Requiere la versión 0.45.6+ del cursor
Para configurar Dumpling AI MCP en Cursor:
- Abrir configuración del cursor
- Vaya a Características > Servidores MCP
- Haga clic en "+ Agregar nuevo servidor MCP"
- Introduzca lo siguiente:
{
"mcpServers": {
"dumplingai": {
"command": "npx",
"args": ["-y", "mcp-server-dumplingai"],
"env": {
"DUMPLING_API_KEY": "<your-api-key>"
}
}
}
}
Si está usando Windows y tiene problemas, pruebe cmd /c "set DUMPLING_API_KEY=your-api-key && npx -y mcp-server-dumplingai"
Reemplace your-api-key con su clave API de Dumpling AI.
Configuración
Variables de entorno
DUMPLING_API_KEY : Su clave API de Dumpling AI (obligatoria)
Herramientas disponibles
API de datos
1. Obtener la transcripción de YouTube ( get-youtube-transcript )
Extraiga 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. Buscar ( search )
Realice búsquedas web en Google y, opcionalmente, extraiga 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 )
Obtenga sugerencias de autocompletar 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 mapas ( search-maps )
Busque 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 )
Busque 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 )
Busque artículos de noticias con parámetros personalizables.
{
"name": "search-news",
"arguments": {
"query": "climate change",
"country": "us",
"language": "en",
"dateRange": "pastWeek"
}
}
7. Obtén reseñas de Google ( get-google-reviews )
Recupere reseñas de Google de empresas o lugares.
{
"name": "get-google-reviews",
"arguments": {
"businessName": "Eiffel Tower",
"location": "Paris, France",
"limit": 10,
"sortBy": "relevance"
}
}
Web Scraping
8. Raspar ( scrape )
Extraer contenido de una página web con opciones de formato.
{
"name": "scrape",
"arguments": {
"url": "https://example.com",
"format": "markdown",
"cleaned": true,
"renderJs": true
}
}
9. Gatear ( crawl )
Rastrear sitios web de forma recursiva y extraer 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 )
Capture capturas de pantalla de páginas web con opciones de formato y ventana gráfica personalizables.
{
"name": "screenshot",
"arguments": {
"url": "https://example.com",
"width": 1280,
"height": 800,
"fullPage": true,
"format": "png",
"waitFor": 1000
}
}
Extraiga datos estructurados de páginas web utilizando 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 )
Convierta documentos a texto sin formato 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 archivos a PDF.
{
"name": "convert-to-pdf",
"arguments": {
"url": "https://example.com/document.docx",
"format": "docx",
"options": {
"quality": 90,
"pageSize": "A4",
"margin": 10
}
}
}
14. Fusionar archivos PDF ( merge-pdfs )
Combine varios archivos 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 vídeo ( trim-video )
Extraer un clip específico de un vídeo.
{
"name": "trim-video",
"arguments": {
"url": "https://example.com/video.mp4",
"startTime": 30,
"endTime": 60,
"output": "mp4",
"options": {
"quality": 720,
"fps": 30
}
}
}
Extraer 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
}
}
}
Extraer texto e información de imágenes.
{
"name": "extract-image",
"arguments": {
"url": "https://example.com/image.jpg",
"extractionType": "text",
"options": {
"language": "en",
"detectOrientation": true
}
}
}
Transcribir y extraer 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
}
}
}
Extraiga 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
}
}
}
Extraer metadatos de archivos PDF.
{
"name": "read-pdf-metadata",
"arguments": {
"url": "https://example.com/document.pdf",
"includeExtended": true
}
}
Actualizar 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"]
}
}
}
AI
22. Generar finalización del agente ( generate-agent-completion )
Obtenga finalizaciones de agente 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 la base de conocimientos ( search-knowledge-base )
Busque en una base de conocimientos información relevante.
{
"name": "search-knowledge-base",
"arguments": {
"kbId": "kb_12345",
"query": "How to optimize database performance",
"limit": 5,
"similarityThreshold": 0.7
}
}
24. Agregar a la base de conocimientos ( add-to-knowledge-base )
Agregar entradas a una base de conocimientos.
{
"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 de IA ( generate-ai-image )
Generar imágenes utilizando 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 )
Genere imágenes utilizando 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 para desarrolladores
27. Ejecutar código JavaScript ( run-js-code )
Ejecutar 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 )
Ejecutar 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 API
- Validación de entrada mediante esquemas 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: consulte el archivo de LICENCIA para obtener más detalles