Skip to main content
Glama
Sign In
enesjakozh

Dumpling AI MCP Server

by Dumpling-AI
GitHub
JavaScript
MIT License
2
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Dumpling AI MCP Server

A Model Context Protocol (MCP) server implementation that integrates with Dumpling AI for data scraping, content processing, knowledge management, AI agents, and code execution capabilities.

Features

  • Complete integration with all Dumpling AI API endpoints
  • Data APIs for YouTube transcripts, search, autocomplete, maps, places, news, and reviews
  • Web scraping with support for scraping, crawling, screenshots, and structured data extraction
  • Document conversion tools for text extraction, PDF operations, video processing
  • Extract data from documents, images, audio, and video
  • AI capabilities including agent completions, knowledge base management, and image generation
  • Developer tools for running JavaScript and Python code in a secure environment
  • Automatic error handling and detailed response formatting

Installation

Installing via Smithery

To install mcp-server-dumplingai for Claude Desktop automatically via Smithery:

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

Running with npx

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

Manual Installation

npm install -g mcp-server-dumplingai

Running on Cursor

Configuring Cursor 🖥️ Note: Requires Cursor version 0.45.6+

To configure Dumpling AI MCP in Cursor:

  1. Open Cursor Settings
  2. Go to Features > MCP Servers
  3. Click "+ Add New MCP Server"
  4. Enter the following:
{ "mcpServers": { "dumplingai": { "command": "npx", "args": ["-y", "mcp-server-dumplingai"], "env": { "DUMPLING_API_KEY": "<your-api-key>" } } } }

If you are using Windows and are running into issues, try cmd /c "set DUMPLING_API_KEY=your-api-key && npx -y mcp-server-dumplingai"

Replace your-api-key with your Dumpling AI API key.

Configuration

Environment Variables

  • DUMPLING_API_KEY: Your Dumpling AI API key (required)

Available Tools

Data APIs

1. Get YouTube Transcript (get-youtube-transcript)

Extract transcripts from YouTube videos with optional timestamps.

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

Perform Google web searches and optionally scrape content from results.

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

3. Get Autocomplete (get-autocomplete)

Get Google search autocomplete suggestions for a query.

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

4. Search Maps (search-maps)

Search Google Maps for locations and businesses.

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

5. Search Places (search-places)

Search for places with more detailed information.

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

6. Search News (search-news)

Search for news articles with customizable parameters.

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

7. Get Google Reviews (get-google-reviews)

Retrieve Google reviews for businesses or places.

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

Web Scraping

8. Scrape (scrape)

Extract content from a web page with formatting options.

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

9. Crawl (crawl)

Recursively crawl websites and extract content with customizable parameters.

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

10. Screenshot (screenshot)

Capture screenshots of web pages with customizable viewport and format options.

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

11. Extract (extract)

Extract structured data from web pages using AI-powered instructions.

{ "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 } }

Document Conversion

12. Doc to Text (doc-to-text)

Convert documents to plaintext with optional OCR.

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

13. Convert to PDF (convert-to-pdf)

Convert various file formats to PDF.

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

14. Merge PDFs (merge-pdfs)

Combine multiple PDFs into a single document.

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

15. Trim Video (trim-video)

Extract a specific clip from a video.

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

16. Extract Document (extract-document)

Extract specific content from documents in various formats.

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

17. Extract Image (extract-image)

Extract text and information from images.

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

18. Extract Audio (extract-audio)

Transcribe and extract information from audio files.

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

19. Extract Video (extract-video)

Extract content from videos including transcripts, scenes, and objects.

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

20. Read PDF Metadata (read-pdf-metadata)

Extract metadata from PDF files.

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

21. Write PDF Metadata (write-pdf-metadata)

Update metadata in PDF files.

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

AI

22. Generate Agent Completion (generate-agent-completion)

Get AI agent completions with optional tool definitions.

{ "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. Search Knowledge Base (search-knowledge-base)

Search a knowledge base for relevant information.

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

24. Add to Knowledge Base (add-to-knowledge-base)

Add entries to a knowledge base.

{ "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. Generate AI Image (generate-ai-image)

Generate images using AI models.

{ "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. Generate Image (generate-image)

Generate images using various AI providers.

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

Developer Tools

27. Run JavaScript Code (run-js-code)

Execute JavaScript code with optional dependencies.

{ "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. Run Python Code (run-python-code)

Execute Python code with optional dependencies.

{ "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 } }

Error Handling

The server provides robust error handling:

  • Detailed error messages with HTTP status codes
  • API key validation
  • Input validation using Zod schemas
  • Network error handling with descriptive messages

Example error response:

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

Development

# Install dependencies npm install # Build npm run build

License

MIT License - see LICENSE file for details

This server cannot be installed

-
security - not tested
-
license - not tested
-
quality - not tested

Integrates with Dumpling AI to provide data scraping, content processing, knowledge management, and code execution capabilities through tools for web interactions, document handling, and AI services.

  1. Features
    1. Installation
      1. Installing via Smithery
      2. Running with npx
      3. Manual Installation
      4. Running on Cursor
    2. Configuration
      1. Environment Variables
    3. Available Tools
      1. Data APIs
      2. Web Scraping
      3. Document Conversion
      4. AI
      5. Developer Tools
    4. Error Handling
      1. Development
        1. License
          ID: 4z1mg2uhzn