by Dumpling-AI
Provides a comprehensive Model Context Protocol server that integrates all Dumpling AI endpoints, enabling data extraction, web scraping, document processing, AI agent interactions, image generation, and secure execution of JavaScript or Python code via a single HTTP interface.
The server implements the Model Context Protocol for Dumpling AI, exposing a large set of tools such as YouTube transcript extraction, web search, Google Maps, document‑to‑text conversion, PDF manipulation, video trimming, AI agent completions, knowledge‑base queries, image generation, and sandboxed code execution. All functionalities are reachable through well‑defined JSON‑based tool definitions.
npx
, global npm install, or through Smithery.DUMPLING_API_KEY
environment variable.npx -y mcp-server-dumplingai
).scrape
, crawl
, screenshot
, extract
with AI‑driven structured extraction.generate-agent-completion
with tool definitions to build autonomous assistants.Q: Which command is recommended for installation?
A: Use npx -y mcp-server-dumplingai
– it installs and runs the server without a global install.
Q: What environment variable is required?
A: DUMPLING_API_KEY
must contain a valid Dumpling AI API key.
Q: Can I run the server inside Cursor? A: Yes, add the MCP server configuration to Cursor’s settings as described in the README.
Q: How are errors returned?
A: Errors are returned as JSON with an isError
flag and a descriptive text
message.
Q: Are there limits on code execution?
A: Each run-js-code
or run-python-code
request can specify a timeout
; the server enforces this limit for safety.
Q: Is the server open‑source? A: It is released under the MIT License; the source code is available on GitHub.
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.
To install mcp-server-dumplingai for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @Dumpling-AI/mcp-server-dumplingai --client claude
env DUMPLING_API_KEY=your_api_key npx -y mcp-server-dumplingai
npm install -g mcp-server-dumplingai
Configuring Cursor 🖥️ Note: Requires Cursor version 0.45.6+
To configure Dumpling AI MCP in Cursor:
{
"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.
DUMPLING_API_KEY
: Your Dumpling AI API key (required)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"
}
}
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
}
}
}
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"
}
}
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
}
}
search-places
)Search for places with more detailed information.
{
"name": "search-places",
"arguments": {
"query": "hotels in paris",
"country": "fr",
"language": "en",
"page": 1
}
}
search-news
)Search for news articles with customizable parameters.
{
"name": "search-news",
"arguments": {
"query": "climate change",
"country": "us",
"language": "en",
"dateRange": "pastWeek"
}
}
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"
}
}
scrape
)Extract content from a web page with formatting options.
{
"name": "scrape",
"arguments": {
"url": "https://example.com",
"format": "markdown",
"cleaned": true,
"renderJs": true
}
}
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
}
}
}
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
}
}
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
}
}
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"
}
}
}
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
}
}
}
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
}
}
}
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
}
}
}
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
}
}
}
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
}
}
}
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
}
}
}
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
}
}
}
read-pdf-metadata
)Extract metadata from PDF files.
{
"name": "read-pdf-metadata",
"arguments": {
"url": "https://example.com/document.pdf",
"includeExtended": true
}
}
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"]
}
}
}
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."]
}
}
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
}
}
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
}
}
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"
}
}
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
}
}
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
}
}
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
}
}
The server provides robust error handling:
Example error response:
{
"content": [
{
"type": "text",
"text": "Error: Failed to fetch YouTube transcript: 404 Not Found"
}
],
"isError": true
}
# Install dependencies
npm install
# Build
npm run build
MIT License - see LICENSE file for details
Please log in to share your review and rating for this MCP.
{ "mcpServers": { "dumplingai": { "command": "npx", "args": [ "-y", "mcp-server-dumplingai" ], "env": { "DUMPLING_API_KEY": "<YOUR_API_KEY>" } } } }
Discover more MCP servers with similar functionality and use cases
by danny-avila
Provides a customizable ChatGPT‑like web UI that integrates dozens of AI models, agents, code execution, image generation, web search, speech capabilities, and secure multi‑user authentication, all open‑source and ready for self‑hosting.
by ahujasid
BlenderMCP integrates Blender with Claude AI via the Model Context Protocol (MCP), enabling AI-driven 3D scene creation, modeling, and manipulation. This project allows users to control Blender directly through natural language prompts, streamlining the 3D design workflow.
by pydantic
Enables building production‑grade generative AI applications using Pydantic validation, offering a FastAPI‑like developer experience.
by GLips
Figma-Context-MCP is a Model Context Protocol (MCP) server that provides Figma layout information to AI coding agents. It bridges design and development by enabling AI tools to directly access and interpret Figma design data for more accurate and efficient code generation.
by mcp-use
Easily create and interact with MCP servers using custom agents, supporting any LLM with tool calling and offering multi‑server, sandboxed, and streaming capabilities.
by sonnylazuardi
This project implements a Model Context Protocol (MCP) integration between Cursor AI and Figma, allowing Cursor to communicate with Figma for reading designs and modifying them programmatically.
by lharries
WhatsApp MCP Server is a Model Context Protocol (MCP) server for WhatsApp that allows users to search, read, and send WhatsApp messages (including media) through AI models like Claude. It connects directly to your personal WhatsApp account via the WhatsApp web multi-device API and stores messages locally in a SQLite database.
by idosal
GitMCP is a free, open-source remote Model Context Protocol (MCP) server that transforms any GitHub project into a documentation hub, enabling AI tools to access up-to-date documentation and code directly from the source to eliminate "code hallucinations."
by Klavis-AI
Klavis AI provides open-source Multi-platform Control Protocol (MCP) integrations and a hosted API for AI applications. It simplifies connecting AI to various third-party services by managing secure MCP servers and authentication.