MCP-Lingvanex-Translate

MCP प्रोटोटाइप – अनुवाद सर्वर

यह प्रोजेक्ट पाठ अनुवाद के लिए एक MCP (मॉडल संदर्भ प्रोटोकॉल) सर्वर लागू करता है। सर्वर दो परिवहनों का समर्थन करता है:

• stdio – Claude Desktop के साथ एकीकरण के लिए
• http (स्ट्रीम करने योग्य) – HTTP + SSE के माध्यम से परीक्षण और कार्य करने के लिए

---

⚙️ आवश्यकताएँ

• Node.js >= 18
• Yarn या npm
• स्थापित Claude Desktop (stdio एकीकरण के लिए)
• पाठ अनुवाद के लिए Lingvanex Translator खाता

---

🔑 Lingvanex Translator सेटअप

Lingvanex Translator का उपयोग करने के लिए आपको एक Lingvanex खाते की आवश्यकता होगी।

1. यदि आपके पास नहीं है, तो मुफ़्त में साइन अप करें

2. Cloud API टैब पर जाएँ: Cloud API

3. बिलिंग पता डेटा भरें

4. भुगतान जारी रखें पर क्लिक करें

   • मुफ़्त परीक्षण प्राप्त करने के लिए, अपना भुगतान कार्ड जोड़ना आवश्यक नहीं है

5. आपकी API कुंजी उत्पन्न हो जाएगी और Cloud API टैब में दिखाई देगी: API कुंजी

अब आप अनुवाद API का उपयोग शुरू करने के लिए तैयार हैं। नीचे समग्र प्रक्रिया का एक वीडियो ट्यूटोरियल है (यदि Lingvanex साइट पर उपलब्ध हो)।

---

🚀 स्थापना और निर्माण

# Clone the repository
git clone https://github.com/lingvanex-mt/MCP-Lingvanex-Translate.git
cd mcp-prototype

निर्भरताएँ स्थापित करें

yarn install

---

🔌 stdio मोड में चलाएँ (Claude Desktop)

stdio मोड का उपयोग Claude Desktop द्वारा स्थानीय MCP सर्वरों से जुड़ने के लिए किया जाता है।

पर्यावरण चर सेट करें:

TRANSPORT=stdio

सर्वर प्रारंभ करें:

yarn build
yarn start

अपेक्षित आउटपुट:

MCP stdio transport running
Translate MCP Server ready

---

🌐 HTTP मोड में चलाएँ (स्ट्रीम करने योग्य)

http मोड HTTP परिवहन के साथ एक स्थानीय HTTP सर्वर चलाता है। ब्राउज़र परीक्षण या curl के साथ उपयोगी।

पर्यावरण चर सेट करें:

TRANSPORT=http
HTTP_PORT=3000

सर्वर प्रारंभ करें:

yarn build
yarn start

सर्वर का परीक्षण करें:

curl http://127.0.0.1:3000/ping

अपेक्षित प्रतिक्रिया:

{ "status": "ok", "transport": "http" }

डिबगिंग के लिए MCP Inspector का उपयोग करें:

npx @modelcontextprotocol/inspector

MCP Inspector UI में, परिवहन प्रकार - स्ट्रीम करने योग्य HTTP चुनें; URL - http://localhost:3000/mcp. कनेक्ट पर क्लिक करें।

---

🖥️ Claude Desktop के साथ एकीकरण

Claude Desktop कॉन्फ़िग फ़ाइल के माध्यम से स्थानीय MCP सर्वरों की खोज करता है:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

उदाहरण कॉन्फ़िग (Windows)

claude_desktop_config.json खोलें (या बनाएँ) और जोड़ें:

{
  "mcpServers": {
    "translate": {
      "command": "node",
      "args": [
        "C:\\Users\\path\\to\\project\\dist\\index.js"
      ]
    }
  }
}

⚠️ निर्माण के बाद अपने स्थानीय dist/index.js का पथ अपडेट करना सुनिश्चित करें!

---

✅ सत्यापित कैसे करें

1. Claude Desktop लॉन्च करें।
2. एक अनुरोध दर्ज करें जैसे: "MCP टूल translate_text का उपयोग करके 'Hello world' का रूसी में अनुवाद करें।"
3. यदि सब कुछ सही ढंग से कॉन्फ़िगर किया गया है, तो Claude आपके MCP सर्वर को कॉल करेगा और अनुवाद लौटाएगा।

---

📌 उपलब्ध उपकरण

translate_text

पाठ का एक भाषा से दूसरी भाषा में अनुवाद करें।

तर्क:

• text – अनुवाद करने के लिए पाठ
• sourceLang – स्रोत भाषा कोड (जैसे "en")
• targetLang – लक्ष्य भाषा कोड (जैसे "ru")

उदाहरण अनुरोध:

{
  "tool": "translate_text",
  "args": {
    "text": "Good morning",
    "sourceLang": "en",
    "targetLang": "fr"
  }
}

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

{
  "content": [
    { "type": "text", "text": "Bonjour" }
  ]
}

---