Hydrolix MCP Server

आधिकारिक

हाइड्रोलिक्स टाइम-सीरीज़ डेटालेक एकीकरण जो एलएलएम-आधारित वर्कफ़्लो को स्कीमा अन्वेषण और क्वेरी क्षमताएं प्रदान करता है।

GitHub

दस्तावेज़

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 कॉन्फ़िगर करें

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
"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 दबाएँ या Dock आइकन पर राइट-क्लिक करें और Quit चुनें। Windows पर, सिस्टम ट्रे आइकन का उपयोग करें।

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

Claude Desktop में एक नया वार्तालाप खोलें। टेक्स्ट इनपुट के पास एक टूल/हथौड़ा आइकन देखें — यह पुष्टि करता है कि MCP सर्वर सफलतापूर्वक कनेक्ट हो गया है।
यह पुष्टि करने के लिए कि सब कुछ काम कर रहा है, यह प्रॉम्प्ट आज़माएँ:

अपने 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 प्रोजेक्ट मैनेजर के माध्यम से है, जो एक पृथक वातावरण में अन्य सभी निर्भरताओं को स्थापित करने का प्रबंधन करेगा।

प्रमाणीकरण

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

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

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

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

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

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

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

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

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

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>

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

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)

निम्न स्थान पर स्थित Claude Desktop कॉन्फ़िगरेशन फ़ाइल खोलें:
- macOS पर: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows पर: %APPDATA%/Claude/claude_desktop_config.json
उपयोगकर्ता नाम और पासवर्ड का उपयोग करने के लिए 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>"
      }
    }
  }
}

अपने Hydrolix क्लस्टर को इंगित करने के लिए पर्यावरण चर परिभाषाओं को अपडेट करें।
(अनुशंसित) uvx के लिए कमांड प्रविष्टि का पता लगाएँ और इसे uvx निष्पादन योग्य के पूर्ण पथ से बदलें। यह सुनिश्चित करता है कि सर्वर शुरू करते समय uvx का सही संस्करण उपयोग किया जाए। आप which uvx या where.exe uvx का उपयोग करके यह पथ पा सकते हैं।
परिवर्तनों को लागू करने के लिए 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 पर्याप्त नहीं है।

समापन बिंदु ओवरराइड

ये HYDROLIX_URL से प्राप्त मानों को ओवरराइड करते हैं। वे इन-क्लस्टर परिनियोजन के लिए उपयोगी हैं जहाँ HTTP क्वेरी समापन बिंदु और संस्करण-API विभिन्न आंतरिक होस्टनाम या पोर्ट पर रहते हैं। ओवरराइड वरीयता: स्पष्ट नया चर > पदावनत उपनाम > HYDROLIX_URL-व्युत्पन्न > हार्ड डिफ़ॉल्ट।

HYDROLIX_HTTP_QUERY_HOST / HYDROLIX_HTTP_QUERY_PORT / HYDROLIX_HTTP_QUERY_SECURE: ClickHouse HTTP क्वेरी समापन बिंदु को ओवरराइड करें।
HYDROLIX_VERSION_API_HOST / HYDROLIX_VERSION_API_PORT / HYDROLIX_VERSION_API_SECURE: REST /version जांच समापन बिंदु को ओवरराइड करें। HYDROLIX_VERSION_API_SECURE डिफ़ॉल्ट रूप से हल किए गए HTTP-क्वेरी सुरक्षित मान से विरासत में मिलता है।

पदावनत चर

संक्रमण विंडो के दौरान निम्नलिखित अभी भी सम्मानित हैं लेकिन भविष्य की रिलीज़ में हटा दिए जाएंगे। अपनी सुविधानुसार माइग्रेट करें:

पदावनत	प्रतिस्थापन
`HYDROLIX_HOST`	`HYDROLIX_URL` (पसंदीदा) या `HYDROLIX_HTTP_QUERY_HOST`
`HYDROLIX_PORT`	`HYDROLIX_HTTP_QUERY_PORT`
`HYDROLIX_SECURE`	`HYDROLIX_HTTP_QUERY_SECURE`
`HYDROLIX_API_HOST`	`HYDROLIX_VERSION_API_HOST`
`HYDROLIX_API_PORT`	`HYDROLIX_VERSION_API_PORT`

इनमें से किसी का उपयोग करने वाले बाहरी ऑपरेटरों को HYDROLIX_URL पर माइग्रेशन की सलाह देने वाली एक बार की स्टार्टअप चेतावनी दिखाई देगी। इन-क्लस्टर (o6r-प्रबंधित) परिनियोजन में यह चेतावनी नहीं दिखेगी; उनका माइग्रेशन प्लेटफ़ॉर्म द्वारा नियंत्रित किया जाता है।

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

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

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

सारांश में:

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

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

वैकल्पिक चर

HYDROLIX_VERIFY: SSL प्रमाणपत्र सत्यापन सक्षम/अक्षम करें
- डिफ़ॉल्ट: "true"
- प्रमाणपत्र सत्यापन अक्षम करने के लिए "false" पर सेट करें (उत्पादन के लिए अनुशंसित नहीं)
HYDROLIX_DATABASE: उपयोग करने के लिए डिफ़ॉल्ट डेटाबेस
- डिफ़ॉल्ट: कोई नहीं (सर्वर डिफ़ॉल्ट का उपयोग करता है)
- किसी विशिष्ट डेटाबेस से स्वचालित रूप से कनेक्ट करने के लिए इसे सेट करें
HYDROLIX_MCP_SERVER_TRANSPORT: MCP सर्वर के लिए ट्रांसपोर्ट विधि सेट करता है।
- डिफ़ॉल्ट: "stdio"
- मान्य विकल्प: "stdio", "http", "sse"। यह MCP इंस्पेक्टर जैसे उपकरणों के साथ स्थानीय विकास के लिए उपयोगी है।
HYDROLIX_MCP_BIND_HOST: HTTP या SSE ट्रांसपोर्ट का उपयोग करते समय MCP सर्वर को बाइंड करने के लिए होस्ट
- डिफ़ॉल्ट: "127.0.0.1"
- सभी नेटवर्क इंटरफेस से बाइंड करने के लिए "0.0.0.0" पर सेट करें (डॉकर या रिमोट एक्सेस के लिए उपयोगी)
- केवल तब उपयोग किया जाता है जब ट्रांसपोर्ट "http" या "sse" हो
HYDROLIX_MCP_BIND_PORT: HTTP या SSE ट्रांसपोर्ट का उपयोग करते समय MCP सर्वर को बाइंड करने के लिए पोर्ट
- डिफ़ॉल्ट: "8000"
- केवल तब उपयोग किया जाता है जब ट्रांसपोर्ट "http" या "sse" हो
HYDROLIX_MAX_RAW_TIMERANGE: गैर-सारांश तालिकाओं के विरुद्ध प्रश्नों के लिए अनुमत सेकंड में अधिकतम समय सीमा
- डिफ़ॉल्ट: 21600 (6 घंटे)
- सारांश तालिकाओं को लक्षित करने वाले प्रश्न इस सीमा से प्रभावित नहीं होते हैं

MCP इंस्पेक्टर या HTTP ट्रांसपोर्ट के साथ रिमोट एक्सेस के लिए:

HYDROLIX_URL=https://my-cluster.hydrolix.net
HYDROLIX_USER=default
HYDROLIX_PASSWORD=myPassword
HYDROLIX_MCP_SERVER_TRANSPORT=http
HYDROLIX_MCP_BIND_HOST=0.0.0.0  # Bind to all interfaces
HYDROLIX_MCP_BIND_PORT=4200  # Custom port (default: 8000)

HTTP ट्रांसपोर्ट का उपयोग करते समय, सर्वर कॉन्फ़िगर किए गए पोर्ट (डिफ़ॉल्ट 8000) पर चलेगा। उदाहरण के लिए, उपरोक्त कॉन्फ़िगरेशन के साथ:

MCP एंडपॉइंट: http://localhost:4200/mcp
हेल्थ चेक: http://localhost:4200/health

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" पर सेट हो।

एंड-टू-एंड परीक्षण

tests/e2e/ के तहत एक अलग सूट स्थानीय कार्यशील ट्री को एक लाइव Hydrolix कुबेरनेट्स क्लस्टर में तैनात करता है और चल रहे पॉड के विरुद्ध MCP उपकरणों का स्मोक-परीक्षण करता है। इसे डिफ़ॉल्ट परीक्षण रन और प्री-पुश हुक से बाहर रखा गया है; इसे चलाने के लिए end_to_end pytest मार्कर और क्रेडेंशियल्स के माध्यम से स्पष्ट ऑप्ट-इन की आवश्यकता होती है। रनबुक के लिए tests/e2e/README.md देखें।