Plugged.in MCP Server

आधिकारिक

एक व्यापक प्रॉक्सी जो कई MCP सर्वरों को एकल MCP में संयोजित करता है। यह सर्वरों में टूल्स, प्रॉम्प्ट्स, संसाधनों और टेम्पलेट्स की खोज और प्रबंधन प्रदान करता है, साथ ही MCP सर्वर बनाते समय डिबगिंग के लिए एक प्लेग्राउंड भी प्रदान करता है।

GitHub

131

दस्तावेज़

plugged.in MCP हब — प्रॉक्सी · ज्ञान · स्मृति · उपकरण

AI डेटा आदान-प्रदान का चौराहा

एक एकीकृत MCP हब जो आपके AI को ज्ञान, स्मृति, और उपकरण देता है — सिर्फ एक प्रॉक्सी नहीं। सभी MCP सर्वरों को एक ही कनेक्शन से प्रबंधित और परीक्षण करें, साथ ही क्लाइंट्स में दस्तावेज़-जागरूक और स्मृति-संवर्धित वर्कफ़्लो को सशक्त करें।

📋 अवलोकन

plugged.in MCP प्रॉक्सी सर्वर एक शक्तिशाली मिडलवेयर है जो कई Model Context Protocol (MCP) सर्वरों को एक एकीकृत इंटरफ़ेस में समाहित करता है। यह plugged.in ऐप से उपकरण, प्रॉम्प्ट और संसाधन कॉन्फ़िगरेशन प्राप्त करता है और अनुरोधों को बुद्धिमत्तापूर्वक उपयुक्त अंतर्निहित MCP सर्वरों तक रूट करता है।

यह प्रॉक्सी किसी भी MCP क्लाइंट (Claude, Cline, Cursor, आदि) के साथ सहज एकीकरण सक्षम करता है, साथ ही plugged.in इकोसिस्टम के माध्यम से उन्नत प्रबंधन क्षमताएँ प्रदान करता है।

हब के स्तंभ: ज्ञान · स्मृति · उपकरण · प्रॉक्सी

ज्ञान (RAG v2 / AI दस्तावेज़ आदान-प्रदान)
एकीकृत, एट्रिब्यूशन-जागरूक दस्तावेज़ पुनर्प्राप्ति के साथ मॉडल आउटपुट खोजें और आधारित करें। MCP सर्वर संस्करणीकरण, दृश्यता नियंत्रण और मॉडल एट्रिब्यूशन के साथ आपकी लाइब्रेरी में दस्तावेज़ बना और प्रबंधित कर सकते हैं। सभी जुड़े स्रोतों में खोजने और प्रासंगिक स्निपेट और मेटाडेटा लौटाने के लिए अंतर्निहित RAG का उपयोग करें।

स्मृति (स्थायी AI स्मृति)
दीर्घकालिक, कार्यक्षेत्र/प्रोफ़ाइल-स्कोप्ड स्मृति जो सत्रों में बनी रहती है। हब plugged.in ऐप की स्थायी स्मृति के साथ एकीकृत होता है ताकि एजेंट क्रियाएँ और अंतर्दृष्टि कार्यों में संग्रहीत और स्मरण की जा सकें। अंतर्निहित स्मृति उपकरण रोडमैप पर हैं जो समान प्रमाणीकरण मॉडल के तहत कम-घर्षण get/put/search पैटर्न उजागर करेंगे।

उपकरण
डाउनस्ट्रीम MCP सर्वरों (STDIO, SSE, स्ट्रीमेबल HTTP) के साथ अंतर्निहित क्षमताओं को समाहित करें। उपकरण खोज कैश की जाती है और मांग पर ताज़ा की जा सकती है; हब-स्तरीय खोज किसी भी MCP क्लाइंट के लिए एक एकीकृत कैटलॉग लौटाती है। हब उपकरणों, संसाधनों, संसाधन टेम्पलेट्स और प्रॉम्प्ट का समर्थन करता है।

प्रॉक्सी
हर क्लाइंट के लिए एक कनेक्शन। STDIO (डिफ़ॉल्ट) या स्ट्रीमेबल HTTP के रूप में चलाएँ, वैकल्पिक API प्रमाणीकरण और स्टेटलेस मोड के साथ। Claude Desktop, Cline, Cursor, MCP Inspector और अधिक के साथ काम करता है; नीतियों और टेलीमेट्री को केंद्रीकृत करते हुए अपने मौजूदा क्लाइंट कॉन्फ़िगरेशन बनाए रखें।

⭐ यदि आपको यह परियोजना उपयोगी लगती है, तो कृपया इसे GitHub पर स्टार देने पर विचार करें! इससे हमें अधिक डेवलपर्स तक पहुँचने में मदद मिलती है और हमें सुधार जारी रखने के लिए प्रेरित करता है।

✨ मुख्य विशेषताएँ

🚀 मुख्य क्षमताएँ

अंतर्निहित AI प्रयोगस्थल: बिना किसी क्लाइंट सेटअप के Claude, Gemini, OpenAI, और xAI के साथ तुरंत अपने MCP का परीक्षण करें
सार्वभौमिक MCP संगतता: Claude Desktop, Cline, और Cursor सहित किसी भी MCP क्लाइंट के साथ काम करता है
बहु-सर्वर समर्थन: STDIO, SSE, और स्ट्रीमेबल HTTP MCP सर्वरों से कनेक्ट करें
दोहरी परिवहन विधियाँ: प्रॉक्सी को STDIO (डिफ़ॉल्ट) या स्ट्रीमेबल HTTP सर्वर के रूप में चलाएँ
एकीकृत दस्तावेज़ खोज: अंतर्निहित RAG क्षमताओं के साथ सभी जुड़े सर्वरों में खोजें
AI दस्तावेज़ आदान-प्रदान (RAG v2): MCP सर्वर पूर्ण एट्रिब्यूशन के साथ आपकी लाइब्रेरी में दस्तावेज़ बना और प्रबंधित कर सकते हैं
किसी भी मॉडल से सूचनाएँ: वैकल्पिक ईमेल वितरण के साथ वास्तविक समय सूचनाएँ प्राप्त करें
बहु-कार्यक्षेत्र परत: एक क्लिक से MCP कॉन्फ़िगरेशन के विभिन्न सेटों के बीच स्विच करें
API-संचालित प्रॉक्सी: प्रत्यक्ष खोज के बजाय plugged.in ऐप API से क्षमताएँ प्राप्त करता है
पूर्ण MCP समर्थन: उपकरणों, संसाधनों, संसाधन टेम्पलेट्स और प्रॉम्प्ट को संभालता है
कस्टम निर्देश: MCP प्रॉम्प्ट के रूप में स्वरूपित सर्वर-विशिष्ट निर्देशों का समर्थन करता है

🎯 v1.5.0 में नया (RAG v2 - AI दस्तावेज़ आदान-प्रदान)

AI दस्तावेज़ निर्माण: MCP सर्वर अब सीधे आपकी लाइब्रेरी में दस्तावेज़ बना सकते हैं
- पूर्ण मॉडल एट्रिब्यूशन ट्रैकिंग (किस AI ने दस्तावेज़ बनाया/अपडेट किया)
- परिवर्तन ट्रैकिंग के साथ संस्करण इतिहास
- SHA-256 हैशिंग के माध्यम से सामग्री डीडुप्लीकेशन
- कई प्रारूपों के लिए समर्थन: MD, TXT, JSON, HTML, PDF, और अधिक
उन्नत दस्तावेज़ खोज: AI फ़िल्टरिंग के साथ संवर्धित RAG क्वेरीज़
- AI मॉडल, प्रदाता, दिनांक सीमा, टैग और स्रोत प्रकार द्वारा फ़िल्टर करें
- प्रासंगिकता स्कोरिंग के साथ सिमेंटिक खोज
- कीवर्ड हाइलाइटिंग के साथ स्वचालित स्निपेट निर्माण
- फ़िल्टरिंग के लिए समर्थन: ai_generated, upload, या api स्रोत
MCP के माध्यम से दस्तावेज़ प्रबंधन:
- दस्तावेज़ दृश्यता सेट करें: निजी, कार्यक्षेत्र, या सार्वजनिक
- दस्तावेज़ संस्करणों के लिए माता-पिता-बच्चे संबंध
- परियोजना-आधारित स्कोपिंग के साथ प्रोफ़ाइल-आधारित संगठन
- दस्तावेज़ प्रसंस्करण के लिए वास्तविक समय प्रगति ट्रैकिंग

🎯 v1.4.0 से सुविधाएँ (रजिस्ट्री v2 समर्थन)

OAuth टोकन प्रबंधन: स्ट्रीमेबल HTTP MCP सर्वरों के लिए सहज OAuth प्रमाणीकरण हैंडलिंग
- plugged.in ऐप से स्वचालित टोकन पुनर्प्राप्ति
- सुरक्षित टोकन भंडारण और रिफ्रेश तंत्र
- किसी क्लाइंट-साइड प्रमाणीकरण की आवश्यकता नहीं
उन्नत सूचना प्रणाली: द्विदिश सूचना समर्थन
- plugged.in ऐप पर सूचनाएँ भेजें
- MCP सर्वरों से सूचनाएँ प्राप्त करें
- सूचनाओं को पढ़ा/अपठित चिह्नित करें
- प्रोग्रामेटिक रूप से सूचनाएँ हटाएँ
ट्रेंडिंग एनालिटिक्स: वास्तविक समय गतिविधि ट्रैकिंग
- प्रत्येक उपकरण कॉल लॉग और ट्रैक किया जाता है
- ट्रेंडिंग सर्वर गणनाओं में योगदान देता है
- उपयोग मेट्रिक्स और लोकप्रियता अंतर्दृष्टि
रजिस्ट्री एकीकरण: रजिस्ट्री v2 सुविधाओं के लिए पूर्ण समर्थन
- रजिस्ट्री से स्वचालित सर्वर खोज
- इंस्टॉलेशन ट्रैकिंग और मेट्रिक्स
- सामुदायिक सर्वर समर्थन

📦 v1.1.0 से सुविधाएँ

स्ट्रीमेबल HTTP समर्थन: स्ट्रीमेबल HTTP परिवहन का उपयोग करने वाले डाउनस्ट्रीम MCP सर्वरों के लिए पूर्ण समर्थन
HTTP सर्वर मोड: कॉन्फ़िगर करने योग्य पोर्ट के साथ प्रॉक्सी को HTTP सर्वर के रूप में चलाएँ
लचीला प्रमाणीकरण: HTTP एंडपॉइंट के लिए वैकल्पिक Bearer टोकन प्रमाणीकरण
सत्र प्रबंधन: स्टेटफुल (सत्र-आधारित) या स्टेटलेस ऑपरेशन मोड के बीच चुनें

🎯 v1.0.0 से मुख्य विशेषताएँ

वास्तविक समय सूचनाएँ: व्यापक सूचना समर्थन के साथ सभी MCP गतिविधियों को ट्रैक करें
RAG एकीकरण: plugged.in ऐप के माध्यम से दस्तावेज़-संवर्धित क्वेरीज़ के लिए समर्थन
इंस्पेक्टर स्क्रिप्ट: डिबगिंग और विकास के लिए स्वचालित परीक्षण उपकरण
स्वास्थ्य निगरानी: कनेक्शन निगरानी के लिए अंतर्निहित पिंग एंडपॉइंट

🔧 उपकरण श्रेणियाँ

प्रॉक्सी उपकरणों की दो अलग-अलग श्रेणियाँ प्रदान करता है:

🔧 स्थैतिक अंतर्निहित उपकरण (हमेशा उपलब्ध)

ये उपकरण प्रॉक्सी में अंतर्निहित हैं और बिना किसी सर्वर कॉन्फ़िगरेशन के काम करते हैं:

pluggedin_discover_tools - तत्काल परिणामों के लिए कैशिंग के साथ स्मार्ट खोज
pluggedin_ask_knowledge_base - AI फ़िल्टरिंग क्षमताओं के साथ आपके दस्तावेज़ों में RAG खोज
pluggedin_send_notification - वैकल्पिक ईमेल वितरण के साथ सूचनाएँ भेजें
pluggedin_create_document - अपनी लाइब्रेरी में AI-जनित दस्तावेज़ बनाएँ
pluggedin_list_documents - फ़िल्टरिंग विकल्पों के साथ दस्तावेज़ सूचीबद्ध करें
pluggedin_search_documents - क्वेरी द्वारा विशिष्ट दस्तावेज़ खोजें
pluggedin_get_document - ID द्वारा किसी विशिष्ट दस्तावेज़ की पूर्ण सामग्री प्राप्त करें
pluggedin_update_document - किसी मौजूदा दस्तावेज़ को अपडेट करें या उसमें जोड़ें

📋 क्लिपबोर्ड उपकरण (स्मृति प्रणाली)

pluggedin_clipboard_set - नाम (सिमेंटिक कुंजी) या इंडेक्स द्वारा क्लिपबोर्ड प्रविष्टि सेट करें
pluggedin_clipboard_get - नाम, इंडेक्स द्वारा क्लिपबोर्ड प्रविष्टियाँ प्राप्त करें, या सभी सूचीबद्ध करें
pluggedin_clipboard_delete - नाम, इंडेक्स द्वारा क्लिपबोर्ड प्रविष्टियाँ हटाएँ, या सभी साफ़ करें
pluggedin_clipboard_list - मेटाडेटा के साथ सभी क्लिपबोर्ड प्रविष्टियाँ सूचीबद्ध करें
pluggedin_clipboard_push - ऑटो-इंक्रीमेंटिंग इंडेक्स के साथ मान पुश करें (स्टैक पुश)
pluggedin_clipboard_pop - उच्चतम-इंडेक्स प्रविष्टि पॉप करें (LIFO व्यवहार)

⚡ गतिशील MCP उपकरण (जुड़े सर्वरों से)

ये उपकरण आपके कॉन्फ़िगर किए गए MCP सर्वरों से आते हैं और इन्हें चालू/बंद किया जा सकता है:

डेटाबेस उपकरण (PostgreSQL, SQLite, आदि)
फ़ाइल सिस्टम उपकरण
API एकीकरण उपकरण
किसी भी MCP सर्वर से कस्टम उपकरण

खोज उपकरण बुद्धिमत्तापूर्वक दोनों श्रेणियों को दिखाता है, AI मॉडलों को सभी उपलब्ध क्षमताओं तक तत्काल पहुँच प्रदान करता है।

🚀 खोज उपकरण उपयोग

# Quick discovery - returns cached data instantly
pluggedin_discover_tools()

# Force refresh - shows current tools + runs background discovery  
pluggedin_discover_tools({"force_refresh": true})

# Discover specific server
pluggedin_discover_tools({"server_uuid": "uuid-here"})

उदाहरण प्रतिक्रिया:

## 🔧 Static Built-in Tools (Always Available):
1. **pluggedin_discover_tools** - Smart discovery with caching
2. **pluggedin_rag_query** - RAG v2 search across documents with AI filtering  
3. **pluggedin_send_notification** - Send notifications
4. **pluggedin_create_document** - (Coming Soon) Create AI-generated documents

## ⚡ Dynamic MCP Tools (8) - From Connected Servers:
1. **query** - Run read-only SQL queries
2. **generate_random_integer** - Generate secure random integers
...

📋 क्लिपबोर्ड उपयोग उदाहरण

क्लिपबोर्ड प्रणाली AI वर्कफ़्लो के लिए स्थायी स्मृति प्रदान करती है:

# Store a named entry (upserts if exists)
pluggedin_clipboard_set({
  "name": "customer_context",
  "value": "{\"name\": \"John Doe\", \"account_id\": \"12345\"}",
  "contentType": "application/json"
})

# Store an indexed entry for ordered pipelines
pluggedin_clipboard_set({
  "idx": 0,
  "value": "First pipeline step result",
  "createdByTool": "data_processor"
})

# Push to stack (auto-incrementing index)
pluggedin_clipboard_push({
  "value": "Analysis result from step 1",
  "contentType": "text/plain"
})

# Get a specific entry by name
pluggedin_clipboard_get({"name": "customer_context"})

# Pop from stack (LIFO - returns and removes highest index)
pluggedin_clipboard_pop()

# List all entries with metadata
pluggedin_clipboard_list({"limit": 20})

# Delete specific entry
pluggedin_clipboard_delete({"name": "customer_context"})

# Clear all clipboard entries
pluggedin_clipboard_delete({"clearAll": true})

📚 RAG v2 उपयोग उदाहरण

उन्नत RAG v2 प्रणाली MCP सर्वरों को पूर्ण AI एट्रिब्यूशन के साथ दस्तावेज़ बनाने और खोजने की अनुमति देती है:

# Search for documents created by specific AI models
pluggedin_rag_query({
  "query": "system architecture",
  "filters": {
    "modelName": "Claude 3 Opus",
    "source": "ai_generated",
    "tags": ["technical"]
  }
})

# Search across all document sources
pluggedin_rag_query({
  "query": "deployment guide",
  "filters": {
    "dateFrom": "2024-01-01",
    "visibility": "workspace"
  }
})

# Future: Create AI-generated documents (Coming Soon)
pluggedin_create_document({
  "title": "Analysis Report",
  "content": "# Market Analysis\n\nDetailed findings...",
  "format": "md",
  "tags": ["analysis", "market"],
  "metadata": {
    "model": {
      "name": "Claude 3 Opus",
      "provider": "Anthropic"
    }
  }
})

🚀 त्वरित शुरुआत

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

Node.js 18+ (v20+ अनुशंसित)
plugged.in ऐप से एक API कुंजी (इसे plugged.in/api-keys पर प्राप्त करें)

इंस्टॉलेशन

# Install and run with npx (latest v1.0.0)
npx -y @pluggedin/pluggedin-mcp-proxy@latest --pluggedin-api-key YOUR_API_KEY

🔄 v1.0.0 में अपग्रेड करना

मौजूदा इंस्टॉलेशन के लिए, विस्तृत अपग्रेड निर्देशों के लिए हमारी माइग्रेशन गाइड देखें।

# Quick upgrade
npx -y @pluggedin/[email protected] --pluggedin-api-key YOUR_API_KEY

MCP क्लाइंट के लिए कॉन्फ़िगरेशन

Claude Desktop

अपने Claude Desktop कॉन्फ़िगरेशन में निम्नलिखित जोड़ें:

{
  "mcpServers": {
    "pluggedin": {
      "command": "npx",
      "args": ["-y", "@pluggedin/pluggedin-mcp-proxy@latest"],
      "env": {
        "PLUGGEDIN_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Cline

अपने Cline कॉन्फ़िगरेशन में निम्नलिखित जोड़ें:

{
  "mcpServers": {
    "pluggedin": {
      "command": "npx",
      "args": ["-y", "@pluggedin/pluggedin-mcp-proxy@latest"],
      "env": {
        "PLUGGEDIN_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Cursor

Cursor के लिए, आप पर्यावरण चर के बजाय कमांड-लाइन तर्कों का उपयोग कर सकते हैं:

npx -y @pluggedin/pluggedin-mcp-proxy@latest --pluggedin-api-key YOUR_API_KEY

⚙️ कॉन्फ़िगरेशन विकल्प

पर्यावरण चर

चर	विवरण	आवश्यक	डिफ़ॉल्ट
`PLUGGEDIN_API_KEY`	plugged.in ऐप से API कुंजी	हाँ	-
`PLUGGEDIN_API_BASE_URL`	plugged.in ऐप के लिए आधार URL	नहीं	`https://plugged.in`

कमांड लाइन तर्क

कमांड लाइन तर्क पर्यावरण चर पर प्राथमिकता लेते हैं:

npx -y @pluggedin/pluggedin-mcp-proxy@latest --pluggedin-api-key YOUR_API_KEY --pluggedin-api-base-url https://your-custom-url.com

परिवहन विकल्प

विकल्प	विवरण	डिफ़ॉल्ट
`--transport <type>`	परिवहन प्रकार: `stdio` या `streamable-http`	`stdio`
`--port <number>`	स्ट्रीमेबल HTTP सर्वर के लिए पोर्ट	`12006`
`--stateless`	स्ट्रीमेबल HTTP के लिए स्टेटलेस मोड सक्षम करें	`false`
`--require-api-auth`	स्ट्रीमेबल HTTP अनुरोधों के लिए API कुंजी आवश्यक करें	`false`

विकल्पों की पूरी सूची के लिए:

npx -y @pluggedin/pluggedin-mcp-proxy@latest --help

🌐 स्ट्रीमेबल HTTP मोड

प्रॉक्सी STDIO के बजाय HTTP सर्वर के रूप में चल सकता है, जो वेब-आधारित पहुँच और दूरस्थ कनेक्शन सक्षम करता है।

बुनियादी उपयोग

# Run as HTTP server on default port (12006)
npx -y @pluggedin/pluggedin-mcp-proxy@latest --transport streamable-http --pluggedin-api-key YOUR_API_KEY

# Custom port
npx -y @pluggedin/pluggedin-mcp-proxy@latest --transport streamable-http --port 8080 --pluggedin-api-key YOUR_API_KEY

# With authentication required
npx -y @pluggedin/pluggedin-mcp-proxy@latest --transport streamable-http --require-api-auth --pluggedin-api-key YOUR_API_KEY

# Stateless mode (new session per request)
npx -y @pluggedin/pluggedin-mcp-proxy@latest --transport streamable-http --stateless --pluggedin-api-key YOUR_API_KEY

HTTP एंडपॉइंट

POST /mcp - MCP संदेश भेजें
GET /mcp - सर्वर-प्रेषित ईवेंट स्ट्रीम (वैकल्पिक)
DELETE /mcp - सत्र समाप्त करें
GET /health - स्वास्थ्य जाँच एंडपॉइंट

सत्र प्रबंधन

स्टेटफुल मोड (डिफ़ॉल्ट) में, सत्र बनाए रखने के लिए mcp-session-id हेडर का उपयोग करें:

# First request creates a session
curl -X POST http://localhost:12006/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

# Subsequent requests use the same session
curl -X POST http://localhost:12006/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: YOUR_SESSION_ID" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"tool_name"},"id":2}'

प्रमाणीकरण

--require-api-auth का उपयोग करते समय, अपनी API कुंजी को Bearer टोकन के रूप में शामिल करें:

curl -X POST http://localhost:12006/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"ping","id":1}'

🐳 डॉकर उपयोग

आप डॉकर का उपयोग करके प्रॉक्सी सर्वर भी बना और चला सकते हैं।

इमेज बनाना

सुनिश्चित करें कि आपके पास डॉकर स्थापित और चल रहा है। pluggedin-mcp निर्देशिका में नेविगेट करें और चलाएँ:

docker build -t pluggedin-mcp-proxy:latest .

बिल्ड संदर्भ को अनुकूलित करने के लिए एक .dockerignore फ़ाइल शामिल है।

कंटेनर चलाना

STDIO मोड (डिफ़ॉल्ट)

MCP इंस्पेक्टर परीक्षण के लिए कंटेनर को STDIO मोड में चलाएँ:

docker run -it --rm \
  -e PLUGGEDIN_API_KEY="YOUR_API_KEY" \
  -e PLUGGEDIN_API_BASE_URL="YOUR_API_BASE_URL" \
  --name pluggedin-mcp-container \
  pluggedin-mcp-proxy:latest

स्ट्रीमेबल HTTP मोड

कंटेनर को HTTP सर्वर के रूप में चलाएँ:

docker run -d --rm \
  -e PLUGGEDIN_API_KEY="YOUR_API_KEY" \
  -e PLUGGEDIN_API_BASE_URL="YOUR_API_BASE_URL" \
  -p 12006:12006 \
  --name pluggedin-mcp-http \
  pluggedin-mcp-proxy:latest \
  --transport streamable-http --port 12006

YOUR_API_KEY और YOUR_API_BASE_URL को बदलें (यदि डिफ़ॉल्ट https://plugged.in का उपयोग नहीं कर रहे हैं)।

MCP इंस्पेक्टर के साथ परीक्षण

जब कंटेनर चल रहा हो, आप MCP इंस्पेक्टर का उपयोग करके इससे कनेक्ट कर सकते हैं:

npx @modelcontextprotocol/inspector docker://pluggedin-mcp-container

यह चल रहे कंटेनर के मानक इनपुट/आउटपुट से कनेक्ट होगा।

कंटेनर रोकना

टर्मिनल में Ctrl+C दबाएँ जहाँ docker run निष्पादित हो रहा है। --rm ध्वज सुनिश्चित करता है कि रुकने पर कंटेनर स्वचालित रूप से हटा दिया जाए।

☁️ Smithery क्लाउड परिनियोजन

अपने MCP सर्वरों तक होस्टेड, हमेशा-उपलब्ध पहुँच के लिए plugged.in MCP प्रॉक्सी को Smithery Cloud पर तैनात करें।

त्वरित शुरुआत

smithery.ai पर जाएँ और साइन इन करें
अपने GitHub खाते को कनेक्ट करें और pluggedin-mcp रिपॉजिटरी चुनें
Smithery UI में अपनी Plugged.in API कुंजी कॉन्फ़िगर करें
डिप्लॉय करें और अपना HTTPS एंडपॉइंट प्राप्त करें

लाभ

24/7 उपलब्धता: आपका प्रॉक्सी हमेशा चालू रहता है
शून्य कॉन्फ़िगरेशन: Smithery smithery.yaml से सेटिंग्स का स्वतः पता लगाता है
स्वचालित स्केलिंग: एक साथ कई कनेक्शन संभालें
वेब एक्सेस: वेब अनुप्रयोगों और दूरस्थ क्लाइंट के लिए उपयुक्त

दस्तावेज़ीकरण

पूर्ण डिप्लॉयमेंट निर्देशों, कॉन्फ़िगरेशन विकल्पों, समस्या निवारण और तकनीकी विवरणों के लिए देखें:

📖 Smithery डिप्लॉयमेंट गाइड

स्वायत्त एजेंट (पूर्वावलोकन)

हब को एंड-टू-एंड एजेंटिक लूप्स का समर्थन करने के लिए डिज़ाइन किया गया है:

MCP Client  →  plugged.in MCP Hub  →  (Plan → Act → Reflect)
                                ↘  Knowledge  ↘  Memory  ↘  Tools

योजना — लक्ष्य और बाधाएँ निकालें, कार्य ग्राफ बनाएँ।
कार्य — एकीकृत कैटलॉग से उपकरण बुलाएँ; STDIO/SSE/HTTP सर्वरों पर सुरक्षित रूप से रूट करें।
चिंतन — परिणामों को मेमोरी और नॉलेज (दस्तावेज़, नोट्स, आर्टिफैक्ट) में सहेजें ताकि बाद के चरणों में सुधार हो सके।

सुरक्षा और संचालन
स्ट्रीमेबल HTTP मोड में --require-api-auth सक्षम करें; कमांड, आर्गुमेंट और env के लिए अनुमति सूचियों का उपयोग करें। सर्वर-स्तरीय सत्यापन को प्रॉम्प्ट-इंजेक्शन के विरुद्ध कठोर क्लाइंट-साइड प्रॉम्प्ट के साथ संयोजित करें। उपकरण उपयोग और दस्तावेज़ उत्परिवर्तनों को ट्रैक करने के लिए मौजूदा लॉगिंग/टेलीमेट्री का लाभ उठाएँ।

🏗️ सिस्टम आर्किटेक्चर

plugged.in MCP प्रॉक्सी सर्वर MCP क्लाइंट और कई अंतर्निहित MCP सर्वरों के बीच एक सेतु का काम करता है:

sequenceDiagram
    participant MCPClient as MCP Client (e.g. Claude Desktop)
    participant PluggedinMCP as plugged.in MCP Proxy
    participant PluggedinApp as plugged.in App
    participant MCPServers as Underlying MCP Servers

    MCPClient ->> PluggedinMCP: Request list tools/resources/prompts
    PluggedinMCP ->> PluggedinApp: Get capabilities via API
    PluggedinApp ->> PluggedinMCP: Return capabilities (prefixed)

    MCPClient ->> PluggedinMCP: Call tool/read resource/get prompt
    alt Standard capability
        PluggedinMCP ->> PluggedinApp: Resolve capability to server
        PluggedinApp ->> PluggedinMCP: Return server details
        PluggedinMCP ->> MCPServers: Forward request to target server
        MCPServers ->> PluggedinMCP: Return response
    else Custom instruction
        PluggedinMCP ->> PluggedinApp: Get custom instruction
        PluggedinApp ->> PluggedinMCP: Return formatted messages
    end
    PluggedinMCP ->> MCPClient: Return response

    alt Discovery tool (Smart Caching)
        MCPClient ->> PluggedinMCP: Call pluggedin_discover_tools
        alt Cached data available
            PluggedinMCP ->> PluggedinApp: Check cached capabilities
            PluggedinApp ->> PluggedinMCP: Return cached tools/resources/prompts
            PluggedinMCP ->> MCPClient: Return instant results (static + dynamic)
        else Force refresh or no cache
            PluggedinMCP ->> PluggedinApp: Trigger background discovery
            PluggedinMCP ->> MCPClient: Return current tools + "discovery running"
            PluggedinApp ->> MCPServers: Connect and discover capabilities (background)
            MCPServers ->> PluggedinApp: Return fresh capabilities
        end
    end

🔄 कार्यप्रवाह

कॉन्फ़िगरेशन: प्रॉक्सी plugged.in ऐप से सर्वर कॉन्फ़िगरेशन प्राप्त करता है
स्मार्ट डिस्कवरी (pluggedin_discover_tools):
- कैश जाँच: पहले मौजूदा कैश्ड डेटा की जाँच करता है (< 1 सेकंड)
- तत्काल प्रतिक्रिया: स्थैतिक उपकरण + कैश्ड गतिशील उपकरण तुरंत लौटाता है
- पृष्ठभूमि रिफ्रेश: force_refresh=true के लिए, वर्तमान उपकरण दिखाते हुए पृष्ठभूमि में डिस्कवरी चलाता है
- ताज़ा डिस्कवरी: केवल तभी पूर्ण डिस्कवरी चलाता है जब कोई कैश्ड डेटा मौजूद न हो
क्षमता सूचीकरण: प्रॉक्सी plugged.in ऐप API से खोजी गई क्षमताएँ प्राप्त करता है
- tools/list: /api/tools से प्राप्त करता है (स्थैतिक + गतिशील उपकरण शामिल)
- resources/list: /api/resources से प्राप्त करता है
- resource-templates/list: /api/resource-templates से प्राप्त करता है
- prompts/list: /api/prompts और /api/custom-instructions से प्राप्त करता है, परिणामों को मर्ज करता है
क्षमता समाधान: प्रॉक्सी क्षमताओं को लक्ष्य सर्वरों से हल करता है
- tools/call: उपकरण नाम से उपसर्ग पार्स करता है, आंतरिक मानचित्र में सर्वर खोजता है
- resources/read: सर्वर विवरण प्राप्त करने के लिए /api/resolve/resource?uri=... को कॉल करता है
- prompts/get: कस्टम निर्देश उपसर्ग की जाँच करता है या /api/resolve/prompt?name=... को कॉल करता है
अनुरोध रूटिंग: अनुरोध उपयुक्त अंतर्निहित MCP सर्वर पर भेजे जाते हैं
प्रतिक्रिया प्रबंधन: अंतर्निहित सर्वरों से प्रतिक्रियाएँ क्लाइंट को लौटा दी जाती हैं

🔒 सुरक्षा सुविधाएँ

plugged.in MCP प्रॉक्सी आपके सिस्टम और डेटा की सुरक्षा के लिए व्यापक सुरक्षा उपाय लागू करता है:

इनपुट सत्यापन और स्वच्छता

कमांड इंजेक्शन रोकथाम: सभी कमांड और आर्गुमेंट निष्पादन से पहले अनुमति सूचियों के विरुद्ध मान्य किए जाते हैं
एनवायरनमेंट वेरिएबल सुरक्षा: उद्धरण चिह्नों और बहुपंक्ति मानों के उचित प्रबंधन के साथ .env फ़ाइलों का सुरक्षित पार्सिंग
टोकन सत्यापन: API कुंजियों और प्रमाणीकरण टोकन के लिए मजबूत regex पैटर्न (32-64 हेक्स वर्ण)

नेटवर्क सुरक्षा

SSRF सुरक्षा: URL सत्यापन निम्न तक पहुँच को रोकता है:
- लोकलहोस्ट और लूपबैक पते (127.0.0.1, ::1)
- निजी IP श्रेणियाँ (10.x, 172.16-31.x, 192.168.x)
- लिंक-लोकल पते (169.254.x)
- मल्टीकास्ट और आरक्षित श्रेणियाँ
- सामान्य आंतरिक सेवा पोर्ट (SSH, डेटाबेस, आदि)
हेडर सत्यापन: हेडर इंजेक्शन से सुरक्षा:
- खतरनाक हेडर अवरोधन
- RFC 7230 अनुरूप हेडर नाम सत्यापन
- नियंत्रण वर्ण पहचान
- हेडर आकार सीमाएँ (8KB अधिकतम)
दर सीमा:
- उपकरण कॉल: 60 अनुरोध प्रति मिनट
- API कॉल: 100 अनुरोध प्रति मिनट
त्रुटि स्वच्छता: त्रुटि संदेशों को स्वच्छ करके सूचना प्रकटीकरण रोकता है

प्रक्रिया सुरक्षा

सुरक्षित कमांड निष्पादन: शेल इंजेक्शन रोकने के लिए exec() के बजाय execFile() का उपयोग करता है
कमांड अनुमति सूची: केवल इनके निष्पादन की अनुमति देता है:
- node, npx - Node.js कमांड
- python, python3 - Python कमांड
- uv, uvx, uvenv - UV Python उपकरण
आर्गुमेंट स्वच्छता: सभी आर्गुमेंट से शेल मेटाकैरेक्टर और नियंत्रण वर्ण हटाता है
एनवायरनमेंट वेरिएबल सत्यापन: केवल अंडरस्कोर के साथ अल्फ़ान्यूमेरिक कुंजियों की अनुमति देता है

स्ट्रीमेबल HTTP सुरक्षा

आलसी प्रमाणीकरण: उपकरण खोज के लिए प्रमाणीकरण की आवश्यकता नहीं, संगतता में सुधार
सत्र सुरक्षा: क्रिप्टोग्राफ़िक रूप से सुरक्षित सत्र ID निर्माण
CORS सुरक्षा: वेब एक्सेस के लिए कॉन्फ़िगर करने योग्य CORS हेडर
अनुरोध आकार सीमाएँ: बड़े पेलोड के माध्यम से DoS रोकता है

सुरक्षा उपयोगिताएँ

एक समर्पित security-utils.ts मॉड्यूल प्रदान करता है:

बियरर टोकन सत्यापन
SSRF सुरक्षा के साथ URL सत्यापन
कमांड आर्गुमेंट स्वच्छता
एनवायरनमेंट वेरिएबल सत्यापन
दर सीमा कार्यान्वयन
त्रुटि संदेश स्वच्छता

विस्तृत सुरक्षा कार्यान्वयन के लिए, SECURITY.md देखें।

🧩 plugged.in ऐप के साथ एकीकरण

plugged.in MCP प्रॉक्सी सर्वर plugged.in ऐप के साथ सहजता से काम करने के लिए डिज़ाइन किया गया है, जो प्रदान करता है:

MCP सर्वर कॉन्फ़िगरेशन प्रबंधित करने के लिए वेब-आधारित इंटरफ़ेस
केंद्रीकृत क्षमता खोज (उपकरण, संसाधन, टेम्पलेट, प्रॉम्प्ट)
RAG v2 दस्तावेज़ लाइब्रेरी: दस्तावेज़ अपलोड करें और पूर्ण एट्रिब्यूशन के साथ AI-जनित सामग्री सक्षम करें
कस्टम निर्देश प्रबंधन
विभिन्न कॉन्फ़िगरेशन सेट के लिए बहु-कार्यक्षेत्र समर्थन
किसी भी AI मॉडल के साथ MCP उपकरणों के परीक्षण के लिए इंटरैक्टिव प्लेग्राउंड
उपयोगकर्ता प्रमाणीकरण और API कुंजी प्रबंधन
AI दस्तावेज़ विनिमय: मॉडल एट्रिब्यूशन ट्रैकिंग के साथ दस्तावेज़ बनाएँ, खोजें और प्रबंधित करें

📚 संबंधित संसाधन

🤝 योगदान

योगदान का स्वागत है! कृपया बेझिझक पुल अनुरोध सबमिट करें।

📝 हाल के अपडेट

संस्करण 1.9.0 (सितंबर 2025) - सुरक्षा संवर्द्धन

🔒 उन्नत HTML स्वच्छता

उद्योग-मानक स्वच्छता: कस्टम regex-आधारित HTML स्वच्छता को sanitize-html लाइब्रेरी से बदला गया
XSS रोकथाम: क्रॉस-साइट स्क्रिप्टिंग हमलों के विरुद्ध व्यापक सुरक्षा
HTML विशेषता सुरक्षा: HTML विशेषता संदर्भों (उद्धरण, एम्परसेंड) के लिए उन्नत स्वच्छता
फ़ॉर्मेट स्ट्रिंग इंजेक्शन: लॉगिंग में फ़ॉर्मेट स्ट्रिंग इंजेक्शन कमजोरियों को ठीक किया गया
सुरक्षा परीक्षण: सभी स्वच्छता कार्यों के लिए व्यापक परीक्षण कवरेज

🛡️ सुरक्षा सुधार

CodeQL अनुपालन: GitHub CodeQL विश्लेषण द्वारा पहचानी गई सभी सुरक्षा कमजोरियों का समाधान
इनपुट सत्यापन: सभी कार्यों में इनपुट सत्यापन और स्वच्छता को मजबूत किया गया
निर्भरता अपडेट: मजबूत HTML सामग्री फ़िल्टरिंग के लिए sanitize-html जोड़ा गया
परीक्षण कवरेज: XSS हमला रोकथाम सत्यापन के साथ उन्नत सुरक्षा परीक्षण सूट

संस्करण 1.5.0 (जनवरी 2025) - RAG v2

🤖 AI दस्तावेज़ विनिमय

AI-जनित दस्तावेज़: MCP सर्वर अब पूर्ण AI एट्रिब्यूशन के साथ आपकी लाइब्रेरी में दस्तावेज़ बना सकते हैं
मॉडल एट्रिब्यूशन ट्रैकिंग: किस AI मॉडल ने प्रत्येक दस्तावेज़ बनाया या अपडेट किया, इसका पूरा इतिहास
उन्नत दस्तावेज़ खोज: AI मॉडल, प्रदाता, दिनांक, टैग और स्रोत प्रकार के अनुसार फ़िल्टर करें
दस्तावेज़ संस्करणीकरण: AI-जनित सामग्री के लिए परिवर्तन ट्रैक करें और संस्करण इतिहास बनाए रखें
बहु-स्रोत समर्थन: अपलोड, AI निर्माण, या API एकीकरण से दस्तावेज़

🔍 उन्नत RAG क्षमताएँ

अर्थपूर्ण खोज: PostgreSQL पूर्ण-पाठ खोज के साथ बेहतर प्रासंगिकता स्कोरिंग
स्मार्ट फ़िल्टरिंग: दृश्यता, मॉडल एट्रिब्यूशन और दस्तावेज़ स्रोत द्वारा परिणाम फ़िल्टर करें
स्निपेट निर्माण: कीवर्ड हाइलाइटिंग के साथ स्वचालित स्निपेट निष्कर्षण
प्रदर्शन अनुकूलन: अनुकूलित इंडेक्सिंग के साथ तेज़ क्वेरीज़

संस्करण 1.2.0 (जनवरी 2025)

🔒 सुरक्षा संवर्द्धन

URL सत्यापन: निजी IP, लोकलहोस्ट और खतरनाक पोर्ट को अवरुद्ध करने वाली व्यापक SSRF सुरक्षा
कमांड अनुमति सूची: केवल स्वीकृत कमांड (node, npx, python, आदि) निष्पादित किए जा सकते हैं
हेडर स्वच्छता: हेडर इंजेक्शन हमलों से सुरक्षा
आलसी प्रमाणीकरण: प्रमाणीकरण-मुक्त उपकरण खोज के साथ बेहतर Smithery संगतता

🚀 प्रदर्शन सुधार

अनुकूलित Docker बिल्ड: न्यूनतम कंटेनर फ़ुटप्रिंट के लिए बहु-चरण बिल्ड
केवल उत्पादन निर्भरताएँ: परीक्षण फ़ाइलें और dev निर्भरताएँ Docker छवियों से बाहर रखी गईं
संसाधन दक्षता: संसाधन-बाधित वातावरण में डिप्लॉयमेंट के लिए डिज़ाइन किया गया

🔧 तकनीकी सुधार

स्ट्रीमेबल HTTP ट्रांसपोर्ट में उन्नत त्रुटि प्रबंधन
बेहतर सत्र सफाई और मेमोरी प्रबंधन
बेहतर TypeScript प्रकार और कोड संगठन

संस्करण 1.1.0 (दिसंबर 2024)

🚀 नई सुविधाएँ

स्ट्रीमेबल HTTP समर्थन: आधुनिक स्ट्रीमेबल HTTP ट्रांसपोर्ट का उपयोग करके डाउनस्ट्रीम MCP सर्वरों से कनेक्ट करें
HTTP सर्वर मोड: वेब-आधारित एक्सेस के लिए प्रॉक्सी को HTTP सर्वर के रूप में चलाएँ
लचीला सत्र प्रबंधन: स्टेटलेस या स्टेटफुल मोड के बीच चुनें
प्रमाणीकरण विकल्प: HTTP एंडपॉइंट के लिए वैकल्पिक बियरर टोकन प्रमाणीकरण
स्वास्थ्य निगरानी: सेवा निगरानी के लिए /health एंडपॉइंट

🔧 तकनीकी सुधार

नवीनतम प्रोटोकॉल समर्थन के लिए MCP SDK को v1.13.1 में अपडेट किया गया
HTTP सर्वर कार्यक्षमता के लिए Express.js एकीकरण जोड़ा गया
बेहतर डेवलपर अनुभव के लिए उन्नत TypeScript प्रकार

संस्करण 1.0.0 (जून 2025)

🎯 प्रमुख विशेषताएँ

रीयल-टाइम अधिसूचना प्रणाली: व्यापक अधिसूचना समर्थन के साथ सभी MCP गतिविधियों को ट्रैक करें
RAG एकीकरण: plugged.in ऐप के माध्यम से दस्तावेज़-उन्नत क्वेरीज़ के लिए समर्थन
इंस्पेक्टर स्क्रिप्ट: डिबगिंग और विकास के लिए नए स्वचालित परीक्षण उपकरण
स्वास्थ्य निगरानी: कनेक्शन निगरानी के लिए अंतर्निहित पिंग एंडपॉइंट

🔒 सुरक्षा संवर्द्धन

इनपुट सत्यापन: सभी इनपुट के लिए उद्योग-मानक सत्यापन और स्वच्छता
URL सुरक्षा: SSRF सुरक्षा के साथ उन्नत URL सत्यापन
एनवायरनमेंट सुरक्षा: dotenv के साथ एनवायरनमेंट वेरिएबल्स की सुरक्षित पार्सिंग
त्रुटि स्वच्छता: त्रुटि प्रतिक्रियाओं में सूचना प्रकटीकरण रोकता है

🐛 बग समाधान

JSON-RPC प्रोटोकॉल हस्तक्षेप ठीक किया गया (stdout बनाम stderr पृथक्करण)
विकास वातावरण के लिए लोकलहोस्ट URL सत्यापन हल किया गया
इंस्पेक्टर स्क्रिप्ट में API कुंजी प्रबंधन ठीक किया गया
बेहतर कनेक्शन स्थिरता और मेमोरी प्रबंधन

🔧 डेवलपर उपकरण

स्वचालित परीक्षण के लिए नई इंस्पेक्टर स्क्रिप्ट
बेहतर त्रुटि संदेश और डिबगिंग क्षमताएँ
उचित stderr उपयोग के साथ संरचित लॉगिंग
उन्नत TypeScript प्रकार सुरक्षा

पूर्ण विवरण के लिए रिलीज़ नोट्स देखें।

🧪 परीक्षण और विकास

स्थानीय विकास

परीक्षण विकास उद्देश्यों के लिए शामिल हैं लेकिन कंटेनर फ़ुटप्रिंट को न्यूनतम करने के लिए Docker बिल्ड से बाहर रखे गए हैं।

# Run tests locally
npm test
# or
./scripts/test-local.sh

# Run tests in watch mode
npm run test:watch

# Run tests with UI
npm run test:ui

हल्के Docker बिल्ड

Docker छवि न्यूनतम फ़ुटप्रिंट के लिए अनुकूलित है:

बहु-चरण निर्माण प्रक्रिया
अंतिम छवि में केवल उत्पादन निर्भरताएँ
परीक्षण फ़ाइलें और dev निर्भरताएँ बाहर रखी गईं
संसाधन-बाधित वातावरण के लिए अनुकूलित

# Build optimized Docker image
docker build -t pluggedin-mcp .

# Check image size
docker images pluggedin-mcp

📄 लाइसेंस

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

🙏 आभार

MCP प्रॉक्सी सर्वर से प्रेरित
मॉडल कॉन्टेक्स्ट प्रोटोकॉल पर निर्मित