Hydrolix

Hydrolix MCP सर्वर

Hydrolix के लिए एक MCP सर्वर।

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

कुछ ही मिनटों में चालू करें। यह खंड Claude Desktop और Claude Code को कवर करता है।

चरण 1 — पूर्वापेक्षाएँ

शुरू करने से पहले, सुनिश्चित करें कि आपके पास है:

• Hydrolix क्रेडेंशियल — आपका क्लस्टर होस्टनाम और साथ ही एक उपयोगकर्ता नाम/पासवर्ड या एक सेवा खाता टोकन। यदि आपके पास ये नहीं हैं, तो अपने Hydrolix व्यवस्थापक से पूछें।
• Claude Desktop — claude.ai/download से डाउनलोड करें।

चरण 2 — MCP सर्वर स्थापित करें

अपने सेटअप से मेल खाने वाली विधि चुनें:

विकल्प A: uv का उपयोग करना (अनुशंसित)

uv Python को स्वचालित रूप से प्रबंधित करता है और मांग पर mcp-hydrolix डाउनलोड करता है, इसलिए किसी अलग स्थापना चरण की आवश्यकता नहीं है। यदि आपके पास uv नहीं है, तो इसे स्थापित करें:

macOS / Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows (PowerShell):

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

विकल्प B: pip का उपयोग करना

Python 3.13+ की आवश्यकता है। यदि आपको Python स्थापित करने की आवश्यकता है, तो इसे python.org से डाउनलोड करें।

pip install mcp-hydrolix

चरण 3 — Claude Desktop कॉन्फ़िगर करें

1. Claude Desktop कॉन्फ़िगरेशन फ़ाइल खोलें:

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

2. "mcpServers" ऑब्जेक्ट में निम्नलिखित प्रविष्टि जोड़ें (यदि यह अभी तक मौजूद नहीं है तो इस सामग्री के साथ फ़ाइल बनाएँ):

{
  "mcpServers": {
    "mcp-hydrolix": {
      "command": "uvx",
      "args": [
        "--python",
        "3.13",
        "--refresh-package",
        "mcp-hydrolix",
        "mcp-hydrolix"
      ],
      "env": {
        "HYDROLIX_URL": "https://<your-hydrolix-hostname>",
        "HYDROLIX_USER": "<your-username>",
        "HYDROLIX_PASSWORD": "<your-password>"
      }
    }
  }
}

<your-hydrolix-hostname>, <your-username>, और <your-password> को अपने वास्तविक क्रेडेंशियल से बदलें।

[!NOTE] यदि आपने विकल्प B (pip) का उपयोग किया है, तो इसके बजाय बिना "args" फ़ील्ड के "command": "mcp-hydrolix" का उपयोग करें।

[!TIP] यदि फ़ाइल में पहले से ही अन्य प्रविष्टियाँ हैं, तो पूरी फ़ाइल को बदलने के बजाय मौजूदा "mcpServers" ऑब्जेक्ट के अंदर "mcp-hydrolix" ब्लॉक जोड़ें।

[!NOTE] यदि आप उपयोगकर्ता नाम/पासवर्ड के बजाय सेवा खाता टोकन से प्रमाणित करते हैं, तो प्रमाणीकरण देखें।

कमांड नहीं मिला?

Claude Desktop आपके शेल के PATH के बिना लॉन्च होता है, इसलिए यह बाइनरी का पता नहीं लगा सकता है, भले ही वह स्थापित हो। पूरा पथ ढूंढें और इसे कॉन्फ़िग में "command" मान के रूप में उपयोग करें।

विकल्प A (uv): uvx ढूंढें:

• macOS / Linux: which uvx
• Windows: where.exe uvx

विकल्प B (pip): mcp-hydrolix ढूंढें:

• macOS / Linux: which mcp-hydrolix
• Windows: where.exe mcp-hydrolix

यदि which/where.exe कुछ नहीं लौटाता है, तो बाइनरी आपके PATH पर नहीं है। सबसे साफ समाधान विकल्प A (uv) पर स्विच करना है, जो Python वातावरण और PATH को आपके लिए प्रबंधित करता है।

चरण 4 — Claude Desktop पुनः आरंभ करें

कॉन्फ़िगरेशन लागू करने के लिए ऐप को पुनः आरंभ करें।

macOS / Windows उपयोगकर्ता: पुनः आरंभ करने से पहले Claude को पूरी तरह से छोड़ना सुनिश्चित करें। macOS पर, Cmd+Q दबाएँ या डॉक आइकन पर राइट-क्लिक करें और छोड़ें चुनें। Windows पर, सिस्टम ट्रे आइकन का उपयोग करें।

चरण 5 — सत्यापित करें कि यह काम कर रहा है

1. Claude Desktop में एक नई बातचीत खोलें। टेक्स्ट इनपुट के पास एक टूल/हथौड़ा आइकन देखें — यह पुष्टि करता है कि MCP सर्वर सफलतापूर्वक कनेक्ट हो गया है।

2. यह पुष्टि करने के लिए कि सब कुछ काम कर रहा है, यह संकेत आज़माएँ:

   अपने Hydrolix MCP टूल का उपयोग करके, उपलब्ध डेटाबेस सूचीबद्ध करें।

Claude को list_databases टूल को कॉल करना चाहिए और आपके क्लस्टर से डेटाबेस की एक सूची लौटानी चाहिए।

---

इसके बजाय Claude Code का उपयोग कर रहे हैं?

यदि आप कमांड लाइन पसंद करते हैं, तो सुनिश्चित करें कि uv स्थापित है (चरण 2 से विकल्प A), फिर चलाएँ:

claude mcp add --transport stdio hydrolix \
  --env HYDROLIX_URL=https://<your-hydrolix-hostname> \
  --env HYDROLIX_USER=<your-username> \
  --env HYDROLIX_PASSWORD=<your-password> \
  --env HYDROLIX_MCP_SERVER_TRANSPORT=stdio \
  -- uvx --python 3.13 --refresh-package mcp-hydrolix mcp-hydrolix

फिर Claude Code खोलें और उसी संकेत के साथ परीक्षण करें:

अपने Hydrolix MCP टूल का उपयोग करके, उपलब्ध डेटाबेस सूचीबद्ध करें।

इसके बजाय VS Code का उपयोग कर रहे हैं?

एक-क्लिक स्थापना के लिए इस README के शीर्ष पर VS Code में स्थापित करें बैज पर क्लिक करें। यदि आप UI प्रवाह पसंद करते हैं, तो कमांड पैलेट खोलें (Cmd+Shift+P / Ctrl+Shift+P), MCP: सर्वर जोड़ें चलाएँ, कमांड (stdio) चुनें, और चरण 3 से uvx ... कमांड और env ब्लॉक का पुन: उपयोग करें।

उपकरण

• run_select_query

  • अपने Hydrolix क्लस्टर पर SQL क्वेरी निष्पादित करें।
  • इनपुट: sql (स्ट्रिंग): निष्पादित करने के लिए SQL क्वेरी।

• list_databases

  • अपने Hydrolix क्लस्टर पर सभी डेटाबेस सूचीबद्ध करें।

• list_tables

  • किसी डेटाबेस में सभी तालिकाएँ सूचीबद्ध करें।
  • इनपुट: database (स्ट्रिंग): डेटाबेस का नाम।

• get_table_info

  • स्कीमा जैसे तालिका मेटाडेटा प्राप्त करें
  • इनपुट: database (स्ट्रिंग): डेटाबेस का नाम।
  • इनपुट: table (स्ट्रिंग): तालिका का नाम।

प्रभावी उपयोग

LLM आर्किटेक्चर में व्यापक विविधता के कारण, सभी मॉडल उपरोक्त उपकरणों का सक्रिय रूप से उपयोग नहीं करेंगे, और कुछ मॉडल को प्रदान किए गए सावधानीपूर्वक निर्मित उपकरण विवरणों के साथ भी, बिना मार्गदर्शन के प्रभावी ढंग से उपयोग करेंगे। Hydrolix MCP सर्वर का उपयोग करते समय अपने मॉडल से सर्वोत्तम परिणाम प्राप्त करने के लिए, हम निम्नलिखित की अनुशंसा करते हैं:

• अपने Hydrolix डेटाबेस को नाम से संदर्भित करें और अपने संकेतों में उपकरण उपयोग का अनुरोध करें (जैसे, "मेरे Hydrolix डेटाबेस तक पहुँचने के लिए MCP उपकरणों का उपयोग करते हुए, कृपया ...")
  • यह मॉडल को उपलब्ध MCP उपकरणों का उपयोग करने के लिए प्रोत्साहित करता है और मतिभ्रम को कम करता है।
• अपने संकेतों में समय सीमाएँ शामिल करें (जैसे, "5 दिसंबर 2023 और 18 जनवरी 2024 के बीच, ...") और विशेष रूप से अनुरोध करें कि आउटपुट टाइमस्टैम्प द्वारा क्रमबद्ध हो।
  • यह मॉडल को अधिक कुशल क्वेरी लिखने के लिए प्रेरित करता है जो प्राथमिक कुंजी अनुकूलन का लाभ उठाती हैं

स्वास्थ्य जाँच समापन बिंदु

HTTP या SSE परिवहन के साथ चलते समय, /health पर एक स्वास्थ्य जाँच समापन बिंदु उपलब्ध है। यह समापन बिंदु:

• यदि सर्वर स्वस्थ है और Hydrolix से कनेक्ट हो सकता है तो Hydrolix क्वेरी-हेड के Clickhouse संस्करण के साथ 200 OK लौटाता है
• यदि सर्वर Hydrolix क्वेरी-हेड से कनेक्ट नहीं हो सकता है तो 503 Service Unavailable लौटाता है

उदाहरण:

curl http://localhost:8000/health
# Response: OK - Connected to Hydrolix compatible with ClickHouse 24.3.1

कॉन्फ़िगरेशन

Hydrolix MCP सर्वर एक मानक MCP सर्वर प्रविष्टि का उपयोग करके कॉन्फ़िगर किया गया है। MCP सर्वरों को कहाँ खोजना या घोषित करना है, इस पर विशिष्ट निर्देशों के लिए अपने क्लाइंट के दस्तावेज़ देखें। Claude Desktop का उपयोग करके एक उदाहरण सेटअप नीचे प्रलेखित है।

Hydrolix MCP सर्वर लॉन्च करने का अनुशंसित तरीका uv प्रोजेक्ट मैनेजर के माध्यम से है, जो एक पृथक वातावरण में अन्य सभी निर्भरताओं को स्थापित करने का प्रबंधन करेगा।

प्रमाणीकरण

सर्वर निम्नलिखित पूर्वता (उच्चतम से निम्नतम) के साथ कई प्रमाणीकरण विधियों का समर्थन करता है:

1. प्रति-अनुरोध बियरर टोकन: Authorization: Bearer <token> हेडर के माध्यम से प्रदान किया गया सेवा खाता टोकन
2. प्रति-अनुरोध GET पैरामीटर: ?token=<token> क्वेरी पैरामीटर के माध्यम से प्रदान किया गया सेवा खाता टोकन
3. पर्यावरण-आधारित क्रेडेंशियल: पर्यावरण चर के माध्यम से कॉन्फ़िगर किए गए क्रेडेंशियल
   • सेवा खाता टोकन (HYDROLIX_TOKEN), या
   • उपयोगकर्ता नाम और पासवर्ड (HYDROLIX_USER और HYDROLIX_PASSWORD)

जब कई प्रमाणीकरण विधियाँ कॉन्फ़िगर की जाती हैं, तो सर्वर उपरोक्त पूर्वता क्रम में पहली उपलब्ध विधि का उपयोग करेगा। प्रति-अनुरोध प्रमाणीकरण केवल HTTP या SSE परिवहन मोड का उपयोग करते समय उपलब्ध है।

नोट: केवल-पढ़ने की भूमिका वाले सेवा खाता टोकन का उपयोग करने की अनुशंसा की जाती है।

उपयोगकर्ता नाम और पासवर्ड का उपयोग करके MCP सर्वर परिभाषा (JSON):

{
  "command": "uvx",
  "args": [
    "--python",
    "3.13",
    "--refresh-package",
    "mcp-hydrolix",
    "mcp-hydrolix"
  ],
  "env": {
    "HYDROLIX_URL": "https://<hydrolix-host>",
    "HYDROLIX_USER": "<hydrolix-user>",
    "HYDROLIX_PASSWORD": "<hydrolix-password>"
  }
}

सेवा खाता टोकन का उपयोग करके MCP सर्वर परिभाषा (JSON):

{
  "command": "uvx",
  "args": [
    "--python",
    "3.13",
    "--refresh-package",
    "mcp-hydrolix",
    "mcp-hydrolix"
  ],
  "env": {
    "HYDROLIX_URL": "https://<hydrolix-host>",
    "HYDROLIX_TOKEN": "<hydrolix-service-account-token>"
  }
}

उपयोगकर्ता नाम और पासवर्ड का उपयोग करके MCP सर्वर परिभाषा (YAML):

command: uvx
args:
- --python
- "3.13"
- --refresh-package
- mcp-hydrolix
- mcp-hydrolix
env:
  HYDROLIX_URL: https://<hydrolix-host>
  HYDROLIX_USER: <hydrolix-user>
  HYDROLIX_PASSWORD: <hydrolix-password>

सेवा खाता टोकन का उपयोग करके MCP सर्वर परिभाषा (YAML):

command: uvx
args:
- --python
- "3.13"
- --refresh-package
- mcp-hydrolix
- mcp-hydrolix
env:
  HYDROLIX_URL: https://<hydrolix-host>
  HYDROLIX_TOKEN: <hydrolix-service-account-token>

कॉन्फ़िगरेशन उदाहरण (Claude Desktop)

1. यहाँ स्थित Claude Desktop कॉन्फ़िगरेशन फ़ाइल खोलें:

   • macOS पर: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows पर: %APPDATA%/Claude/claude_desktop_config.json

2. उपयोगकर्ता नाम और पासवर्ड का उपयोग करने के लिए mcpServers कॉन्फ़िग ब्लॉक में एक mcp-hydrolix सर्वर प्रविष्टि जोड़ें:

{
  "mcpServers": {
    "mcp-hydrolix": {
      "command": "uvx",
      "args": [
        "--python",
        "3.13",
        "--refresh-package",
        "mcp-hydrolix",
        "mcp-hydrolix"
      ],
      "env": {
        "HYDROLIX_URL": "https://<hydrolix-host>",
        "HYDROLIX_USER": "<hydrolix-user>",
        "HYDROLIX_PASSWORD": "<hydrolix-password>"
      }
    }
  }
}

सेवा खाते का लाभ उठाने के लिए निम्नलिखित कॉन्फ़िग ब्लॉक का उपयोग करें:

{
  "mcpServers": {
    "mcp-hydrolix": {
      "command": "uvx",
      "args": [
        "--python",
        "3.13",
        "--refresh-package",
        "mcp-hydrolix",
        "mcp-hydrolix"
      ],
      "env": {
        "HYDROLIX_URL": "https://<hydrolix-host>",
        "HYDROLIX_TOKEN": "<hydrolix-service-account-token>"
      }
    }
  }
}

3. अपने Hydrolix क्लस्टर को इंगित करने के लिए पर्यावरण चर परिभाषाओं को अपडेट करें।

4. (अनुशंसित) uvx के लिए कमांड प्रविष्टि का पता लगाएँ और इसे uvx निष्पादन योग्य के पूर्ण पथ से बदलें। यह सुनिश्चित करता है कि सर्वर शुरू करते समय uvx का सही संस्करण उपयोग किया जाए। आप which uvx या where.exe uvx का उपयोग करके यह पथ पा सकते हैं।

5. परिवर्तनों को लागू करने के लिए Claude Desktop को पुनः आरंभ करें। यदि आप Windows का उपयोग कर रहे हैं, तो सिस्टम ट्रे आइकन का उपयोग करके क्लाइंट को बंद करके सुनिश्चित करें कि Claude पूरी तरह से बंद है।

कॉन्फ़िगरेशन उदाहरण (Claude Code)

Claude Code के लिए Hydrolix MCP सर्वर को कॉन्फ़िगर करने के लिए, निम्नलिखित कमांड चलाएँ:

claude mcp add --transport stdio hydrolix \
  --env HYDROLIX_USER=<hydrolix-user> \
  --env HYDROLIX_PASSWORD=<hydrolix-password> \
  --env HYDROLIX_URL=https://<hydrolix-host> \
  --env HYDROLIX_MCP_SERVER_TRANSPORT=stdio \
  -- uvx --python 3.13 --refresh-package mcp-hydrolix mcp-hydrolix

पर्यावरण चर

Hydrolix कनेक्शन को कॉन्फ़िगर करने के लिए निम्नलिखित चर का उपयोग किया जाता है। ये चर MCP कॉन्फ़िग ब्लॉक (जैसा कि ऊपर दिखाया गया है), एक .env फ़ाइल, या पारंपरिक पर्यावरण चर के माध्यम से प्रदान किए जा सकते हैं।

आवश्यक चर

क्लस्टर की पहचान करने के लिए आपको निम्नलिखित में से एक सेट करना होगा:

• HYDROLIX_URL (अनुशंसित): आपके Hydrolix क्लस्टर का विहित सार्वजनिक URL, जैसे https://mycluster.hydrolix.live। विशिष्ट आउट-ऑफ-क्लस्टर परिनियोजन के लिए यह एकल चर पर्याप्त है — यह HTTP क्वेरी समापन बिंदु और REST /version जांच दोनों के लिए होस्ट, पोर्ट (योजना-डिफ़ॉल्ट 443/80), और TLS सेटिंग्स की आपूर्ति करता है।
• HYDROLIX_HOST (पदावनत): आपके Hydrolix सर्वर का होस्टनाम। पश्चगामी संगतता के लिए अभी भी सम्मानित है लेकिन इसे HYDROLIX_URL से बदला जाना चाहिए।

जब HYDROLIX_MCP_SERVER_TRANSPORT http या sse है, तो HYDROLIX_URL विशेष रूप से आवश्यक है (एक आगामी OAuth मेटाडेटा समापन बिंदु इसका विज्ञापन करेगा)। इन परिवहनों के लिए अकेला HYDROLIX_HOST पर्याप्त नहीं है।

प्रमाणीकरण चर

stdio परिवहन का उपयोग करते समय कम से कम एक प्रमाणीकरण विधि कॉन्फ़िगर की जानी चाहिए:

• HYDROLIX_TOKEN: पर्यावरण-आधारित प्रमाणीकरण के लिए सेवा खाता टोकन
• HYDROLIX_USER और HYDROLIX_PASSWORD: पर्यावरण-आधारित प्रमाणीकरण के लिए उपयोगकर्ता नाम और पासवर्ड (दोनों एक साथ प्रदान किए जाने चाहिए)

सारांश में:

• stdio के लिए, आपको HYDROLIX_TOKEN या HYDROLIX_USER+HYDROLIX_PASS (पर्यावरणीय क्रेडेंशियल) का उपयोग करना होगा
• http/sse के लिए, आप HYDROLIX_TOKEN या HYDROLIX_USER+HYDROLIX_PASS (पर्यावरणीय क्रेडेंशियल) का उपयोग कर सकते हैं, लेकिन आप इसके बजाय प्रति-अनुरोध क्रेडेंशियल का उपयोग कर सकते हैं।

यदि पर्यावरण या अनुरोध के माध्यम से कोई क्रेडेंशियल प्रदान नहीं किया जाता है, तो अनुरोध विफल हो जाएगा।

HTTP परिवहन के साथ प्रति-अनुरोध प्रमाणीकरण का उपयोग करना

HTTP या SSE परिवहन का उपयोग करते समय, आप पर्यावरण-आधारित क्रेडेंशियल को छोड़ सकते हैं और इसके बजाय प्रति-अनुरोध प्रमाणीकरण प्रदान कर सकते हैं। यह बहु-उपयोगकर्ता परिदृश्यों के लिए या उन क्लाइंट के साथ उपयोगी है जो स्थानीय रूप से MCP सर्वर चलाने का समर्थन नहीं करते हैं।

प्रति-अनुरोध प्रमाणीकरण के साथ दूरस्थ HTTP सर्वर से कनेक्ट होने वाला उदाहरण mcpServers कॉन्फ़िगरेशन:

{
  "mcpServers": {
    "mcp-hydrolix-remote": {
      "url": "https://my-hydrolix-mcp.example.com/mcp?token=<service-account-token>"
    }
  }
}

पर्यावरण क्रेडेंशियल के बिना अपना स्वयं का HTTP सर्वर चलाने के लिए उदाहरण न्यूनतम .env कॉन्फ़िगरेशन:

HYDROLIX_URL=https://my-cluster.hydrolix.net
HYDROLIX_MCP_SERVER_TRANSPORT=http

हालाँकि MCP विनिर्देश का हिस्सा नहीं है, कई MCP क्लाइंट MCP-जारी अनुरोधों में हेडर जोड़ने की अनुमति देते हैं। जब यह संभव हो, तो हम अधिक सुरक्षा के लिए क्वेरी पैरामीटर के बजाय Authorization: Bearer <sa-token-here> हेडर के माध्यम से सेवा खाता टोकन पास करने के लिए MCP क्लाइंट को कॉन्फ़िगर करने की अनुशंसा करते हैं।

नोट: बाइंड होस्ट और पोर्ट सेटिंग्स का उपयोग केवल तब किया जाता है जब परिवहन "http" या "sse" पर सेट हो।

वैकल्पिक चर

समापन बिंदु ओवरराइड, पदावनत चर उपनाम, और वैकल्पिक ट्यूनिंग चर (टाइमआउट, क्वेरी SETTINGS ओवरराइड, परिणाम ट्रंकेशन, HTTP/SSE वर्कर ट्यूनिंग, प्रॉक्सी, मेट्रिक्स, और एस्केप हैच) के पूर्ण सेट के लिए docs/CONFIG.md देखें।

अनुरक्षक

जिन कार्यों के लिए परिचालन विशेषाधिकारों की आवश्यकता होती है — एक लाइव Hydrolix क्लस्टर के विरुद्ध एंड-टू-एंड सूट चलाना, और एक रिलीज़ काटना — अलग से MAINTAINERS.md में प्रलेखित हैं।