mcpField
D
Dumpling AI MCP Server

Dumpling AI MCP Server

本地服务
github.com/Dumpling-AI浏览器自动化3068 周前更新
代码仓库

关于 Dumpling AI MCP Server

Dumpling AI MCP Server 是 Dumpling AI API 的 MCP 服务实现，覆盖数据抓取、网页采集、文档转换、AI 能力和代码执行。适合需要在 MCP 客户端中直接调用这些接口的开发者。

主要功能

  1. 01YouTube 字幕、搜索、地图、新闻和评论数据
  2. 02网页抓取、爬取、截图与结构化提取
  3. 03PDF、图片、音频、视频的文档处理
  4. 04Agent 补全、知识库和图像生成
  5. 05JavaScript 与 Python 代码执行

适用场景

  1. 01获取 YouTube 视频字幕用于内容分析
  2. 02抓取网页并提取结构化商品信息
  3. 03将文档转换为文本或 PDF

MCP 相关

该项目是 MCP 服务，向 MCP 客户端暴露 Dumpling AI 的多类接口作为工具，例如 scrape、search 和 run-python-code。使用时需配置 DUMPLING_API_KEY 环境变量。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "dumplingai": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
启动命令npx -y @smithery/cli

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@smithery/cli

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Dumpling AI MCP 服务

一种模型上下文协议（MCP）服务实现，可与 Dumpling AI 集成，提供数据抓取、内容处理、知识管理、AI Agent 和代码执行能力。

smithery badge

功能

  • 与所有 Dumpling AI API 端点完整集成
  • 数据 API：支持 YouTube 字幕、搜索、自动补全、地图、地点、新闻和评论
  • 网页抓取：支持抓取、爬取、截图和结构化数据提取
  • 文档转换工具：支持文本提取、PDF 操作和视频处理
  • 从文档、图像、音频和视频中提取数据
  • AI 功能：包括 Agent 补全、知识库管理和图像生成
  • 开发者工具：在安全环境中运行 JavaScript 和 Python 代码
  • 自动错误处理和详细的响应格式化

安装

通过 Smithery 安装

通过 Smithery 为 Claude Desktop 自动安装 mcp-server-dumplingai：

npx -y @smithery/cli install @Dumpling-AI/mcp-server-dumplingai --client claude
使用 npx 运行
env DUMPLING_API_KEY=your_api_key npx -y mcp-server-dumplingai
手动安装
npm install -g mcp-server-dumplingai
在 Cursor 上运行

配置 Cursor 🖥️ 注意：需要 Cursor 0.45.6 或更高版本

在 Cursor 中配置 Dumpling AI MCP：

  1. 打开 Cursor 设置
  2. 前往 Features > MCP Servers
  3. 点击“+ Add New MCP Server”
  4. 输入以下内容：
{
  "mcpServers": {
    "dumplingai": {
      "command": "npx",
      "args": ["-y", "mcp-server-dumplingai"],
      "env": {
        "DUMPLING_API_KEY": "<your-api-key>"
      }
    }
  }
}

如果你使用 Windows 且遇到问题，请尝试 cmd /c "set DUMPLING_API_KEY=your-api-key && npx -y mcp-server-dumplingai"

将 your-api-key 替换为你的 Dumpling AI API 密钥。

配置

环境变量
  • DUMPLING_API_KEY：你的 Dumpling AI API 密钥（必需）

可用工具

数据 API
1. 获取 YouTube 字幕（get-youtube-transcript）

从 YouTube 视频中提取字幕，可选择包含时间戳。

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

执行 Google 网页搜索，并可选择抓取搜索结果中的内容。

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

获取 Google 搜索查询的自动补全建议。

{
  "name": "get-autocomplete",
  "arguments": {
    "query": "how to learn",
    "country": "us",
    "language": "en",
    "location": "New York"
  }
}
4. 搜索地图（search-maps）

在 Google 地图中搜索地点和商家。

{
  "name": "search-maps",
  "arguments": {
    "query": "coffee shops",
    "gpsPositionZoom": "37.7749,-122.4194,14z",
    "language": "en",
    "page": 1
  }
}
5. 搜索地点（search-places）

搜索地点并获取更详细的信息。

{
  "name": "search-places",
  "arguments": {
    "query": "hotels in paris",
    "country": "fr",
    "language": "en",
    "page": 1
  }
}
6. 搜索新闻（search-news）

使用可自定义的参数搜索新闻文章。

{
  "name": "search-news",
  "arguments": {
    "query": "climate change",
    "country": "us",
    "language": "en",
    "dateRange": "pastWeek"
  }
}
7. 获取 Google 评论（get-google-reviews）

获取商家或地点的 Google 评论。

{
  "name": "get-google-reviews",
  "arguments": {
    "businessName": "Eiffel Tower",
    "location": "Paris, France",
    "limit": 10,
    "sortBy": "relevance"
  }
}
网页抓取
8. 抓取（scrape）

从网页中提取内容，并可设置格式选项。

{
  "name": "scrape",
  "arguments": {
    "url": "https://example.com",
    "format": "markdown",
    "cleaned": true,
    "renderJs": true
  }
}
9. 爬取（crawl）

递归爬取网站并提取内容，参数可自定义。

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

截取网页，并可自定义视口和格式选项。

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

使用 AI 驱动的指令从网页中提取结构化数据。

{
  "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
  }
}
文档转换
12. 文档转文本（doc-to-text）

将文档转换为纯文本，并可选择使用 OCR。

{
  "name": "doc-to-text",
  "arguments": {
    "url": "https://example.com/document.pdf",
    "options": {
      "ocr": true,
      "language": "en"
    }
  }
}
13. 转换为 PDF（convert-to-pdf）

将各种文件格式转换为 PDF。

{
  "name": "convert-to-pdf",
  "arguments": {
    "url": "https://example.com/document.docx",
    "format": "docx",
    "options": {
      "quality": 90,
      "pageSize": "A4",
      "margin": 10
    }
  }
}
14. 合并 PDF（merge-pdfs）

将多个 PDF 合并为一个文档。

{
  "name": "merge-pdfs",
  "arguments": {
    "urls": ["https://example.com/doc1.pdf", "https://example.com/doc2.pdf"],
    "options": {
      "addPageNumbers": true,
      "addTableOfContents": true
    }
  }
}
15. 修剪视频（trim-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）

从各种格式的文档中提取指定内容。

{
  "name": "extract-document",
  "arguments": {
    "url": "https://example.com/document.pdf",
    "format": "structured",
    "options": {
      "ocr": true,
      "language": "en",
      "includeMetadata": true
    }
  }
}
17. 提取图像内容（extract-image）

从图像中提取文本和信息。

{
  "name": "extract-image",
  "arguments": {
    "url": "https://example.com/image.jpg",
    "extractionType": "text",
    "options": {
      "language": "en",
      "detectOrientation": true
    }
  }
}
18. 提取音频内容（extract-audio）

转录音频文件并从中提取信息。

{
  "name": "extract-audio",
  "arguments": {
    "url": "https://example.com/audio.mp3",
    "language": "en",
    "options": {
      "model": "enhanced",
      "speakerDiarization": true,
      "wordTimestamps": true
    }
  }
}
19. 提取视频内容（extract-video）

从视频中提取内容，包括字幕、场景和物体。

{
  "name": "extract-video",
  "arguments": {
    "url": "https://example.com/video.mp4",
    "extractionType": "transcript",
    "options": {
      "language": "en",
      "speakerDiarization": true
    }
  }
}
20. 读取 PDF 元数据（read-pdf-metadata）

从 PDF 文件中提取元数据。

{
  "name": "read-pdf-metadata",
  "arguments": {
    "url": "https://example.com/document.pdf",
    "includeExtended": true
  }
}
21. 写入 PDF 元数据（write-pdf-metadata）

更新 PDF 文件中的元数据。

{
  "name": "write-pdf-metadata",
  "arguments": {
    "url": "https://example.com/document.pdf",
    "metadata": {
      "title": "New Title",
      "author": "John Doe",
      "keywords": ["keyword1", "keyword2"]
    }
  }
}
AI
22. 生成 Agent 补全内容（generate-agent-completion）

获取 AI Agent 补全内容，可选择提供工具定义。

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

在知识库中搜索相关信息。

{
  "name": "search-knowledge-base",
  "arguments": {
    "kbId": "kb_12345",
    "query": "How to optimize database performance",
    "limit": 5,
    "similarityThreshold": 0.7
  }
}
24. 添加到知识库（add-to-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. 生成 AI 图像（generate-ai-image）

使用 AI 模型生成图像。

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

使用各种 AI 提供商生成图像。

{
  "name": "generate-image",
  "arguments": {
    "prompt": "A golden retriever in a meadow of wildflowers",
    "provider": "dalle",
    "width": 1024,
    "height": 1024,
    "numImages": 1
  }
}
开发者工具
27. 运行 JavaScript 代码（run-js-code）

运行 JavaScript 代码，可选择使用依赖项。

{
  "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. 运行 Python 代码（run-python-code）

运行 Python 代码，可选择使用依赖项。

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

错误处理

该服务提供完善的错误处理：

  • 包含 HTTP 状态码的详细错误消息
  • API 密钥验证
  • 使用 Zod 模式验证输入
  • 通过描述性消息处理网络错误

错误响应示例：

{
  "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 文件

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。