Dumpling AI MCP Server Dumplingai

🚀 Technical Documentation

This API offers a rich set of features, including network data retrieval, AI agent interaction, and developer tool support. Complex tasks can be accomplished through simple JSON requests, significantly enhancing development efficiency.

🚀 Quick Start

Installation

# Install dependencies
npm install

# Start the server
node index.js

✨ Features

Network

1. Get YouTube Video Information (get-youtube-info)

Retrieve detailed information about a YouTube video.

{
  "name": "get-youtube-info",
  "arguments": {
    "url": "https://www.youtube.com/watch?v=abc123"
  }
}

2. Extract URL Content (extract-url-content)

Extract HTML or other content from a specified URL.

{
  "name": "extract-url-content",
  "arguments": {
    "url": "https://example.com",
    "selector": "#main-content"
  }
}

3. Search YouTube (search-youtube)

Search for videos on YouTube.

{
  "name": "search-youtube",
  "arguments": {
    "query": "Tips for learning programming",
    "results": 10,
    "filter": "videos"
  }
}

4. Get YouTube Subtitles (get-youtube-subtitles)

Retrieve subtitles for a specified video.

{
  "name": "get-youtube-subtitles",
  "arguments": {
    "url": "https://www.youtube.com/watch?v=abc123"
  }
}

AI

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

Use an AI agent to generate completion content.

{
  "name": "generate-agent-completion",
  "arguments": {
    "prompt": "How can I improve the SEO of my website?",
    "model": "gpt-4",
    "temperature": 0.7,
    "maxTokens": 500,
    "context": ["This is an e-commerce website selling handmade products."]
  }
}

6. Search Knowledge Base (search-knowledge-base)

Search for information in a specified knowledge base.

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

Developer Tools

7. Execute JavaScript Code (run-js-code)

Execute specified JavaScript code.

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

Error Handling

The server provides robust error handling:

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

Example error response:

{
  "content": [
    {
      "type": "text",
      "text": "Error: Unable to get YouTube subtitles: 404 Not Found"
    }
  ],
  "isError": true
}

💻 Usage Examples

Example 1: Get Web Page Content

{
  "name": "extract-url-content",
  "arguments": {
    "url": "https://example.com/blog/post.html",
    "selector": ".article-content"
  }
}

Example 2: Search YouTube Videos

{
  "name": "search-youtube",
  "arguments": {
    "query": "Learn the basics of artificial intelligence",
    "results": 5,
    "filter": "videos"
  }
}

Example 3: Execute a Computational Task

{
  "name": "run-js-code",
  "arguments": {
    "code": "function factorial(n) { return n <= 1 ? 1 : n * factorial(n - 1); } console.log(factorial(5));",
    "dependencies": {}
  }
}