YepCode MCP Server

YepCode MCP सर्वर क्या है?

एक MCP (मॉडल कॉन्टेक्स्ट प्रोटोकॉल) सर्वर जो AI प्लेटफ़ॉर्म को YepCode के बुनियादी ढाँचे के साथ इंटरैक्ट करने में सक्षम बनाता है। LLM-जनरेटेड स्क्रिप्ट चलाएँ और अपनी YepCode प्रक्रियाओं को शक्तिशाली उपकरणों में बदलें जिनका AI सहायक सीधे उपयोग कर सकते हैं। YepCode एक गतिशील MCP उपकरण सर्वर बनाने के लिए एकदम सही वातावरण है: प्रत्येक प्रक्रिया को एक उपकरण के रूप में उजागर करें (OAuth, API टोकन, या आपके क्रेडेंशियल्स के साथ), पूर्ण लचीलेपन के लिए JSON स्कीमा के साथ प्रत्येक उपकरण के पैरामीटर परिभाषित करें, और उपकरणों को Python या Node.js में कार्यान्वित करें—सभी एक ही सर्वर में जो कई भाषाओं को मिलाता है।

YepCode MCP सर्वर क्यों?

• सहज AI एकीकरण: बिना किसी कॉन्फ़िगरेशन के YepCode प्रक्रियाओं को AI-तैयार उपकरणों में बदलें
• रीयल-टाइम प्रक्रिया नियंत्रण: AI सिस्टम और आपके वर्कफ़्लो के बीच सीधा संपर्क सक्षम करें
• एंटरप्राइज़-ग्रेड सुरक्षा: YepCode के पृथक, उत्पादन-तैयार वातावरण में कोड निष्पादित करें
• सार्वभौमिक संगतता: मॉडल कॉन्टेक्स्ट प्रोटोकॉल का समर्थन करने वाले किसी भी AI प्लेटफ़ॉर्म के साथ एकीकृत करें

YepCode: एक गतिशील MCP उपकरण सर्वर के लिए एकदम सही वातावरण

YepCode को एक गतिशील MCP उपकरण सर्वर चलाने के लिए आदर्श प्लेटफ़ॉर्म के रूप में बनाया गया है:

• एक प्रक्रिया, एक उपकरण: प्रत्येक YepCode प्रक्रिया को MCP उपकरण के रूप में उजागर किया जा सकता है। अपनी प्रक्रियाओं को टैग करें (जैसे mcp-tool, core, automation) और वे ऐसे उपकरण बन जाते हैं जिन्हें AI सहायक आमंत्रित कर सकते हैं। आप OAuth, API टोकन, या अपने मौजूदा YepCode क्रेडेंशियल्स के साथ पहुँच सुरक्षित कर सकते हैं—प्रत्येक उपकरण आपके कार्यक्षेत्र में समान सुरक्षा मॉडल के साथ चलता है।

• उपकरण पैरामीटर पर पूर्ण नियंत्रण: प्रत्येक उपकरण अपनी पैरामीटर स्कीमा को JSON स्कीमा के रूप में परिभाषित कर सकता है। आपको इनपुट का वर्णन करने के लिए पूर्ण लचीलापन मिलता है (प्रकार, विवरण, आवश्यक फ़ील्ड, एनम, डिफ़ॉल्ट, आदि), ताकि AI को समृद्ध मेटाडेटा प्राप्त हो और वह आपके उपकरणों को सही ढंग से कॉल कर सके।

• बहुभाषी उपकरण कार्यान्वयन: उपकरणों को Python या Node.js (या दोनों) में कार्यान्वित करें। एक ही MCP सर्वर विभिन्न रनटाइम द्वारा समर्थित उपकरणों को उजागर कर सकता है—इसे एक MCP सर्वर के रूप में सोचें जो कई भाषाओं में कार्यान्वयन को मिलाता है।

पूर्ण दस्तावेज़ीकरण के लिए, YepCode MCP सर्वर दस्तावेज़ देखें।

स्थापना

यह पैकेज आपको YepCode MCP सर्वर को स्थानीय रूप से या अपने स्वयं के बुनियादी ढाँचे (NPX, Docker, या कस्टम परिनियोजन) में चलाने देता है। इसे Cursor या Claude Desktop जैसे AI प्लेटफ़ॉर्म के साथ एकीकृत करें।

सुझाव: अपने YepCode खाते से आपके पास एक होस्टेड MCP सर्वर तक पहुँच भी है जिसे स्थानीय स्थापना की आवश्यकता नहीं है। कनेक्शन URL हमेशा होता है: https://cloud.yepcode.io/mcp

पूर्वापेक्षाएँ

अपने YepCode API क्रेडेंशियल्स प्राप्त करें:

1. YepCode Cloud पर साइन अप करें
2. नया API टोकन बनाने के लिए Settings > API credentials पर जाएँ।

NPX का उपयोग करना

सुनिश्चित करें कि आपके पास Node.js स्थापित है (संस्करण 18 या उच्चतर), और निम्नलिखित के समान कॉन्फ़िगरेशन का उपयोग करें:

{
  "mcpServers": {
    "yepcode-mcp-server": {
      "command": "npx",
      "args": ["-y", "@yepcode/mcp-server"],
      "env": {
        "YEPCODE_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Docker का उपयोग करना

1. कंटेनर छवि बनाएँ:

docker build -t yepcode/mcp-server .

2. निम्नलिखित के समान कॉन्फ़िगरेशन का उपयोग करें:

{
  "mcpServers": {
    "yepcode-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-d",
        "-e",
        "YEPCODE_API_TOKEN=your_api_token_here",
        "yepcode/mcp-server"
      ]
    }
  }
}

डिबगिंग

MCP सर्वर को डिबग करना मुश्किल हो सकता है क्योंकि वे stdio पर संचार करते हैं। इसे आसान बनाने के लिए, हम MCP इंस्पेक्टर का उपयोग करने की सलाह देते हैं, जिसे आप निम्न कमांड से चला सकते हैं:

npm run inspector

यह एक सर्वर शुरू करेगा जहाँ आप सीधे अपने ब्राउज़र में डिबगिंग उपकरणों तक पहुँच सकते हैं।

YepCode MCP उपकरण संदर्भ

MCP सर्वर YepCode के बुनियादी ढाँचे के साथ इंटरैक्ट करने के लिए कई उपकरण प्रदान करता है:

कोड निष्पादन

run_code

YepCode के सुरक्षित वातावरण में कोड निष्पादित करता है।

// Input
{
  code: string;                          // The code to execute
  options?: {
    language?: string;                   // Programming language (default: 'javascript')
    comment?: string;                    // Execution context
    settings?: Record<string, unknown>;  // Runtime settings
  }
}

// Response
{
  returnValue?: unknown;                 // Execution result
  logs?: string[];                       // Console output
  error?: string;                        // Error message if execution failed
}

MCP विकल्प

YepCode MCP सर्वर निम्नलिखित विकल्पों का समर्थन करता है:

• runCodeCleanup: run_code क्लीनअप को छोड़ें। डिफ़ॉल्ट रूप से, run_code प्रक्रियाओं का स्रोत कोड निष्पादन के बाद हटा दिया जाता है। यदि आप इसे ऑडिट उद्देश्यों के लिए रखना चाहते हैं, तो आप इस विकल्प का उपयोग कर सकते हैं।
• skipCodingRules: run_code उपकरण परिभाषा में कोडिंग नियमों को शामिल करना छोड़ें। डिफ़ॉल्ट रूप से, AI-जनरेटेड कोड का मार्गदर्शन करने के लिए YepCode दस्तावेज़ीकरण से JavaScript और Python कोडिंग नियम उपकरण स्कीमा में शामिल किए जाते हैं। यदि आप तेज़ उपकरण आरंभीकरण या छोटी उपकरण परिभाषाओं के लिए इसे छोड़ना चाहते हैं, तो आप इस विकल्प का उपयोग कर सकते हैं।

विकल्पों को YEPCODE_MCP_OPTIONS पर्यावरण चर में अल्पविराम-पृथक सूची के रूप में पारित किया जा सकता है।

उपकरण चयन

आप YEPCODE_MCP_TOOLS पर्यावरण चर को उपकरण श्रेणियों और प्रक्रिया टैग की अल्पविराम-पृथक सूची के साथ सेट करके नियंत्रित कर सकते हैं कि कौन से उपकरण सक्षम हैं:

अंतर्निहित उपकरण श्रेणियाँ:

• run_code: कोड निष्पादन उपकरण सक्षम करता है
• yc_api: सभी बुनियादी API प्रबंधन उपकरण सक्षम करता है (प्रक्रियाएँ, शेड्यूल, चर, भंडारण, निष्पादन, मॉड्यूल)
• yc_api_full: संस्करण-संबंधित उपकरणों सहित सभी API प्रबंधन उपकरण सक्षम करता है (अतिरिक्त प्रक्रिया और मॉड्यूल संस्करण प्रबंधन उपकरणों के साथ yc_api का विस्तार करता है)
• कोई विशिष्ट API उपकरण नाम (जैसे, execute_process_sync, get_execution,...)

प्रक्रिया टैग:

• आपकी YepCode प्रक्रियाओं में उपयोग किया गया कोई भी टैग (जैसे, mcp-tool, core, automation, आदि)
• जब आप एक प्रक्रिया टैग निर्दिष्ट करते हैं, तो उस टैग वाली सभी प्रक्रियाएँ व्यक्तिगत MCP उपकरणों के रूप में उजागर की जाएँगी
• प्रक्रिया उपकरणों का नाम प्रक्रिया स्लग का उपयोग करके रखा जाएगा (या यदि नाम 60 वर्णों से अधिक लंबा है तो yc_ और प्रक्रिया ID के साथ उपसर्गित किया जाएगा)

यदि निर्दिष्ट नहीं किया गया है, तो सभी अंतर्निहित उपकरण डिफ़ॉल्ट रूप से सक्षम हैं, लेकिन कोई प्रक्रिया उपकरण उजागर नहीं किए जाएँगे।

// NPX configuration with options
{
  "mcpServers": {
    "yepcode-mcp-server": {
      "command": "npx",
      "args": ["-y", "@yepcode/mcp-server"],
      "env": {
        "YEPCODE_API_TOKEN": "your_api_token_here",
        "YEPCODE_MCP_OPTIONS": "runCodeCleanup,skipCodingRules",
        "YEPCODE_MCP_TOOLS": "run_code,yc_api,mcp-tool,core"
      }
    }
  }
}

उदाहरण परिदृश्य:

• YEPCODE_MCP_TOOLS=run_code,yc_api - अंतर्निहित कोड निष्पादन और बुनियादी API प्रबंधन उपकरण सक्षम करता है
• YEPCODE_MCP_TOOLS=run_code,yc_api_full - अंतर्निहित कोड निष्पादन और सभी API प्रबंधन उपकरण सक्षम करता है (संस्करण प्रबंधन सहित)
• YEPCODE_MCP_TOOLS=core,automation - केवल "core" या "automation" से टैग की गई प्रक्रियाओं को उपकरणों के रूप में उजागर करता है
• YEPCODE_MCP_TOOLS=run_code,yc_api,core - अंतर्निहित उपकरणों और "core" से टैग की गई सभी प्रक्रियाओं को सक्षम करता है

पर्यावरण प्रबंधन

set_env_var

YepCode कार्यक्षेत्र में एक पर्यावरण चर सेट करता है।

// Input
{
  key: string;                           // Variable name
  value: string;                         // Variable value
  isSensitive?: boolean;                 // Whether to mask the value in logs (default: true)
}

remove_env_var

YepCode कार्यक्षेत्र से एक पर्यावरण चर हटाता है।

// Input
{
  key: string;                           // Name of the variable to remove
}

भंडारण प्रबंधन

YepCode एक अंतर्निहित भंडारण प्रणाली प्रदान करता है जो आपको फ़ाइलें अपलोड करने, सूचीबद्ध करने, डाउनलोड करने और हटाने की अनुमति देती है। इन फ़ाइलों तक आपके कोड निष्पादन से yepcode.storage सहायक विधियों का उपयोग करके पहुँचा जा सकता है।

list_files

आपके YepCode भंडारण में सभी फ़ाइलों को सूचीबद्ध करता है।

// Input
{
  prefix?: string;                       // Optional prefix to filter files
}

// Response
{
  files: Array<{
    filename: string;                    // File name or path
    size: number;                        // File size in bytes
    lastModified: string;                // Last modification date
  }>;
}

upload_file

YepCode भंडारण में एक फ़ाइल अपलोड करता है।

// Input
{
  filename: string;                      // File path (e.g., 'file.txt' or 'folder/file.txt')
  content: string | {                   // File content
    data: string;                        // Base64 encoded content for binary files
    encoding: "base64";
  };
}

// Response
{
  success: boolean;                      // Upload success status
  filename: string;                      // Uploaded file path
}

download_file

YepCode भंडारण से एक फ़ाइल डाउनलोड करता है।

// Input
{
  filename: string;                      // File path to download
}

// Response
{
  filename: string;                      // File path
  content: string;                       // File content (base64 for binary files)
  encoding?: string;                     // Encoding type if binary
}

delete_file

YepCode भंडारण से एक फ़ाइल हटाता है।

// Input
{
  filename: string;                      // File path to delete
}

// Response
{
  success: boolean;                      // Deletion success status
  filename: string;                      // Deleted file path
}

प्रक्रिया निष्पादन

MCP सर्वर आपकी YepCode प्रक्रियाओं को व्यक्तिगत MCP उपकरणों के रूप में उजागर कर सकता है, जिससे वे AI सहायकों के लिए सीधे सुलभ हो जाती हैं। यह सुविधा YEPCODE_MCP_TOOLS पर्यावरण चर में प्रक्रिया टैग निर्दिष्ट करके सक्षम की जाती है।

यह कैसे काम करता है:

1. अपनी YepCode प्रक्रियाओं को किसी भी टैग के साथ टैग करें (जैसे, core, api, automation, mcp-tool, आदि)
2. उन टैग को YEPCODE_MCP_TOOLS पर्यावरण चर में जोड़ें
3. निर्दिष्ट टैग वाली सभी प्रक्रियाएँ व्यक्तिगत MCP उपकरणों के रूप में उजागर की जाएँगी

प्रत्येक उजागर प्रक्रिया के लिए एक उपकरण होगा जिसका नाम प्रक्रिया स्लग का उपयोग करके रखा जाएगा (या यदि उपकरण का नाम 60 वर्णों से अधिक लंबा है तो yc_ और प्रक्रिया ID के साथ उपसर्गित किया जाएगा)।

प्रक्रिया टैग के बारे में अधिक जानकारी के लिए, हमारा प्रक्रिया टैग दस्तावेज़ीकरण देखें।

<process_slug>

// Input
{
  parameters?: any;                      // This should match the input parameters specified in the process
  options?: {
    tag?: string;                        // Process version to execute
    comment?: string;                    // Execution context
  };
  synchronousExecution?: boolean;        // Whether to wait for completion (default: true)
}

// Response (synchronous execution)
{
  executionId: string;                   // Unique execution identifier
  logs: string[];                        // Process execution logs
  returnValue?: unknown;                 // Process output
  error?: string;                        // Error message if execution failed
}

// Response (asynchronous execution)
{
  executionId: string;                   // Unique execution identifier
}

API प्रबंधन उपकरण

API प्रबंधन उपकरण श्रेणियाँ (yc_api और yc_api_full) आपके YepCode कार्यक्षेत्र के सभी पहलुओं को प्रबंधित करने के लिए व्यापक API पहुँच प्रदान करती हैं:

बुनियादी API उपकरण (yc_api): yc_api टैग आपके कार्यक्षेत्र में मुख्य संचालन के लिए मानक API प्रबंधन उपकरण सक्षम करता है।

विस्तारित API उपकरण (yc_api_full): yc_api_full टैग में yc_api से सब कुछ और प्रक्रिया और मॉड्यूल संस्करणों के प्रबंधन के लिए अतिरिक्त उपकरण शामिल हैं।

प्रक्रिया प्रबंधन:

• get_processes - वैकल्पिक फ़िल्टरिंग के साथ प्रक्रियाओं की सूची बनाएँ
• create_process - स्रोत कोड के साथ नई प्रक्रियाएँ बनाएँ
• get_process - प्रक्रिया विवरण प्राप्त करें
• update_process - मौजूदा प्रक्रिया अपडेट करें
• delete_process - एक प्रक्रिया हटाएँ
• get_process_versions - प्रक्रिया संस्करण प्राप्त करें (yc_api_full की आवश्यकता है)
• execute_process_async - एक प्रक्रिया को अतुल्यकालिक रूप से निष्पादित करें
• execute_process_sync - एक प्रक्रिया को तुल्यकालिक रूप से निष्पादित करें
• schedule_process - एक प्रक्रिया को स्वचालित रूप से चलाने के लिए शेड्यूल करें

शेड्यूल प्रबंधन:

• get_schedules - शेड्यूल की गई प्रक्रियाओं की सूची बनाएँ
• get_schedule - शेड्यूल विवरण प्राप्त करें
• pause_schedule - शेड्यूल की गई प्रक्रिया को रोकें
• resume_schedule - रुके हुए शेड्यूल को फिर से शुरू करें
• delete_schedule - एक शेड्यूल हटाएँ
• update_schedule - शेड्यूल की गई प्रक्रिया को अपडेट करें

चर प्रबंधन:

• get_variables - टीम चर सूचीबद्ध करें
• create_variable - एक नया चर बनाएँ
• update_variable - मौजूदा चर अपडेट करें
• delete_variable - एक चर हटाएँ

भंडारण प्रबंधन:

• get_storage_objects - भंडारण वस्तुओं की सूची बनाएँ
• upload_storage_object - भंडारण में एक फ़ाइल अपलोड करें
• download_storage_object - भंडारण से एक फ़ाइल डाउनलोड करें
• delete_storage_object - भंडारण से एक फ़ाइल हटाएँ

निष्पादन प्रबंधन:

• get_executions - वैकल्पिक फ़िल्टरिंग के साथ निष्पादन सूचीबद्ध करें
• get_execution - API से निष्पादन विवरण प्राप्त करें
• kill_execution - चल रहे निष्पादन को समाप्त करें
• rerun_execution - पिछले निष्पादन को फिर से चलाएँ
• get_execution_logs - निष्पादन लॉग प्राप्त करें

मॉड्यूल प्रबंधन:

• get_modules - स्क्रिप्ट लाइब्रेरी मॉड्यूल सूचीबद्ध करें
• create_module - एक नया मॉड्यूल बनाएँ
• get_module - मॉड्यूल विवरण प्राप्त करें
• delete_module - एक मॉड्यूल हटाएँ
• get_module_versions - मॉड्यूल संस्करण प्राप्त करें (yc_api_full की आवश्यकता है)
• get_module_version - एक विशिष्ट मॉड्यूल संस्करण प्राप्त करें (yc_api_full की आवश्यकता है)
• delete_module_version - एक मॉड्यूल संस्करण हटाएँ (yc_api_full की आवश्यकता है)
• get_module_aliases - मॉड्यूल संस्करण उपनाम प्राप्त करें (yc_api_full की आवश्यकता है)

लाइसेंस

यह परियोजना MIT लाइसेंस के तहत लाइसेंस प्राप्त है - विवरण के लिए LICENSE फ़ाइल देखें।