Dumpling AI MCP Server
by
Provides comprehensive MCP services that integrate Dumpling AI’s data APIs, web scraping, document conversion, AI agents, knowledge‑base management, and secure JavaScript/Python execution.
Dumpling AI MCP Server Overview
What is Dumpling AI MCP Server about?
Offers a Model Context Protocol (MCP) server that exposes a wide range of Dumpling AI endpoints: YouTube transcript extraction, Google search/autocomplete/maps, news, reviews, generic web scraping, crawling, screenshots, structured data extraction, document‑to‑text, PDF merging, video trimming, media transcription, AI agent completions, knowledge‑base queries, image generation, and sandboxed code execution.
How to use Dumpling AI MCP Server?
- Installation – run the package via npx:
(or install globally withenv DUMPLING_API_KEY=your_api_key npx -y mcp-server-dumplingainpm install -g mcp-server-dumplingai). - Configuration – set the environment variable
DUMPLING_API_KEYwith your Dumpling AI API key. - Invocation – the server listens for MCP requests; each tool is called by name with a JSON payload matching the examples in the README (e.g.,
get-youtube-transcript,scrape,run-python-code). - Integration – add the server to Cursor or any MCP‑compatible client by specifying the command and env as shown in the README.
Key features of Dumpling AI MCP Server
- Complete coverage of Dumpling AI data endpoints (YouTube, Google search, Maps, News, Reviews).
- Advanced web‑scraping suite: single‑page scrape, recursive crawl, screenshot capture, AI‑driven structured extraction.
- Document handling: PDF/Text conversion, OCR, PDF metadata read/write, PDF merging, video trimming, media transcription.
- AI utilities: agent completions, knowledge‑base search/add, image generation (multiple providers), AI image creation.
- Developer tools: secure execution of JavaScript and Python code with custom dependencies and timeouts.
- Automatic error handling with detailed HTTP status codes and Zod‑based input validation.
Use cases of Dumpling AI MCP Server
- Research & Knowledge Management – fetch and summarize web content, transcripts, and news; store results in a knowledge base for later querying.
- Content Creation – extract data from videos/documents, generate images, and run code snippets to automate content pipelines.
- Data Enrichment – scrape product pages, crawl competitor sites, and extract structured data for market analysis.
- Automation & Workflows – combine search, scraping, and AI generation in a single MCP flow to build custom assistants or bots.
- Rapid Prototyping – developers can run JavaScript/Python snippets on the server without setting up local environments.
FAQ from the Dumpling AI MCP Server
Q: Which command should I use to start the server?
A: Prefer the npx approach: env DUMPLING_API_KEY=your_api_key npx -y mcp-server-dumplingai.
Q: Do I need to install anything else besides Node.js? A: No additional runtime is required; the package bundles all dependencies.
Q: How is the API key passed?
A: Set the environment variable DUMPLING_API_KEY before launching the server.
Q: Can I run this on Windows?
A: Yes. Use cmd /c "set DUMPLING_API_KEY=your_api_key && npx -y mcp-server-dumplingai" if you encounter issues.
Q: What security measures exist for running code? A: The server executes JavaScript and Python in isolated sandboxes with configurable timeouts and does not expose the host filesystem.
Dumpling AI MCP Server's README
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:
- Open Cursor Settings
- Go to Features > MCP Servers
- Click "+ Add New MCP Server"
- 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"
}
}
2. Search (search)
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
Dumpling AI MCP Server Reviews
Login Required
Please log in to share your review and rating for this MCP.
Actions
Dumpling AI MCP Server's Information
- Author
- Dumpling-AI
- Category
- Web Scraping
- Language
- JavaScript
- License
- MIT License
- Version
- v1.1.3
- Stars
- 24
- Updated
- 21 days ago
Configuration
{
"mcpServers": {
"dumplingai": {
"command": "npx",
"args": [
"-y",
"mcp-server-dumplingai"
],
"env": {
"DUMPLING_API_KEY": "<YOUR_API_KEY>"
}
}
}
}Configure Clients
Similar MCP Servers like Dumpling AI MCP Server
Explore related MCPs that share similar capabilities and solve comparable challenges
Fetch
Officialby modelcontextprotocol
A Model Context Protocol server that provides web content fetching capabilities.
Playwright MCP
Officialby microsoft
Provides fast, lightweight browser automation using Playwright's accessibility tree, enabling LLMs to interact with web pages through structured snapshots instead of screenshots.
Firecrawl MCP Server
by firecrawl
Provides powerful web scraping capabilities for LLM clients such as Cursor, Claude, and others, enabling content extraction, crawling, search, and batch processing through a Model Context Protocol server.
Fetch MCP Server
by zcaceres
Fetches web content and returns it in HTML, JSON, plain‑text, or Markdown formats, optionally applying custom request headers.
AgentQL MCP
Officialby tinyfish-io
Extract structured data from any web page by invoking AgentQL's extraction tool through a Model Context Protocol server, enabling AI assistants to retrieve and format web information on demand.
Scrapling Fetch MCP
by cyberchitta
Fetches HTML or markdown from bot‑protected websites, delivering plain‑text content that AI assistants can process.
Mcp Rquest
by xxxbrian
Provides realistic browser-like HTTP request capabilities with accurate TLS/JA3/JA4 fingerprints, enabling LLMs to bypass anti-bot measures and retrieve web content, plus conversion of PDF and HTML to Markdown for easier LLM processing.
Puppeteer Vision MCP
by djannot
Scrape webpages and convert them to well‑formatted markdown, automatically handling cookies, captchas, paywalls and other interactive elements using AI‑driven vision analysis.
WebScraping AI MCP Server
by webscraping-ai
Provides Model Context Protocol tools for extracting, rendering, and querying web page content via WebScraping.AI services.