Hydrolix MCP Server

ทางการ

การรวมข้อมูลไทม์ซีรีส์ดาต้าเลคของ Hydrolix ที่ให้ความสามารถในการสำรวจสคีมาและสอบถามข้อมูลสำหรับเวิร์กโฟลว์ที่ใช้ LLM

GitHub

เอกสาร

Hydrolix MCP Server

เซิร์ฟเวอร์ MCP สำหรับ Hydrolix

เริ่มต้นอย่างรวดเร็ว

เริ่มต้นใช้งานได้ภายในไม่กี่นาที ส่วนนี้ครอบคลุม 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) ให้ใช้ "command": "mcp-hydrolix" โดยไม่มีฟิลด์ "args" แทน

[!TIP] หากไฟล์มีรายการอื่นอยู่แล้ว ให้เพิ่มบล็อก "mcp-hydrolix" ภายในออบเจกต์ "mcpServers" ที่มีอยู่ แทนที่จะแทนที่ทั้งไฟล์

[!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 แล้ว (ตัวเลือก A จาก ขั้นตอนที่ 2) จากนั้นรัน:

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 แทนหรือไม่?

คลิกป้าย Install in VS Code ที่ด้านบนของ README นี้เพื่อติดตั้งในคลิกเดียว หากคุณต้องการขั้นตอน UI ให้เปิด Command Palette (Cmd+Shift+P / Ctrl+Shift+P) รัน MCP: Add Server เลือก Command (stdio) และใช้คำสั่ง uvx ... และบล็อก env จาก ขั้นตอนที่ 3 อีกครั้ง

เครื่องมือ

run_select_query
- รันคิวรี SQL บนคลัสเตอร์ Hydrolix ของคุณ
- อินพุต: sql (สตริง): คิวรี SQL ที่จะรัน
list_databases
- แสดงรายการฐานข้อมูลทั้งหมดบนคลัสเตอร์ Hydrolix ของคุณ
list_tables
- แสดงรายการตารางทั้งหมดในฐานข้อมูล
- อินพุต: database (สตริง): ชื่อของฐานข้อมูล
get_table_info
- รับข้อมูลเมตาของตาราง เช่น สคีมา
- อินพุต: database (สตริง): ชื่อของฐานข้อมูล
- อินพุต: table (สตริง): ชื่อของตาราง

การใช้งานอย่างมีประสิทธิภาพ

เนื่องจากความหลากหลายของสถาปัตยกรรม LLM ไม่ใช่ทุกรุ่นที่จะใช้เครื่องมือข้างต้นในเชิงรุก และมีเพียงไม่กี่รุ่นที่จะใช้อย่างมีประสิทธิภาพหากไม่มีคำแนะนำ แม้ว่าจะมีคำอธิบายเครื่องมือที่สร้างขึ้นอย่างพิถีพิถันให้กับโมเดลก็ตาม เพื่อให้ได้ผลลัพธ์ที่ดีที่สุดจากโมเดลของคุณขณะใช้เซิร์ฟเวอร์ Hydrolix MCP เราขอแนะนำดังต่อไปนี้:

อ้างถึงฐานข้อมูล Hydrolix ของคุณตามชื่อและขอให้ใช้เครื่องมือในพรอมต์ของคุณ (เช่น "ใช้เครื่องมือ MCP เพื่อเข้าถึงฐานข้อมูล Hydrolix ของฉัน โปรด ...")
- สิ่งนี้กระตุ้นให้โมเดลใช้เครื่องมือ MCP ที่มีอยู่และลดการสร้างข้อมูลเท็จ
รวมช่วงเวลาในพรอมต์ของคุณ (เช่น "ระหว่างวันที่ 5 ธันวาคม 2023 ถึง 18 มกราคม 2024 ...") และขอให้ผลลัพธ์เรียงลำดับตามการประทับเวลาโดยเฉพาะ
- สิ่งนี้กระตุ้นให้โมเดลเขียนคิวรีที่มีประสิทธิภาพมากขึ้นซึ่งใช้ประโยชน์จาก การเพิ่มประสิทธิภาพคีย์หลัก

ปลายทางการตรวจสอบความสมบูรณ์

เมื่อรันด้วยการขนส่ง HTTP หรือ SSE จะมีปลายทางการตรวจสอบความสมบูรณ์ที่ /health ปลายทางนี้:

ส่งคืน 200 OK พร้อมกับเวอร์ชัน Clickhouse ของ Hydrolix query-head หากเซิร์ฟเวอร์สมบูรณ์ดีและสามารถเชื่อมต่อกับ Hydrolix ได้
ส่งคืน 503 Service Unavailable หากเซิร์ฟเวอร์ไม่สามารถเชื่อมต่อกับ Hydrolix query-head ได้

ตัวอย่าง:

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 ซึ่งจะจัดการการติดตั้งการพึ่งพาอื่นๆ ทั้งหมดในสภาพแวดล้อมที่แยกออกมา

การตรวจสอบสิทธิ์

เซิร์ฟเวอร์รองรับวิธีการตรวจสอบสิทธิ์หลายวิธีโดยมีลำดับความสำคัญดังต่อไปนี้ (สูงสุดไปต่ำสุด):

โทเค็น Bearer ต่อคำขอ: โทเค็นบัญชีบริการที่ให้ผ่านส่วนหัว Authorization: Bearer <token>
พารามิเตอร์ GET ต่อคำขอ: โทเค็นบัญชีบริการที่ให้ผ่านพารามิเตอร์คิวรี ?token=<token>
ข้อมูลประจำตัวตามสภาพแวดล้อม: ข้อมูลประจำตัวที่กำหนดค่าผ่านตัวแปรสภาพแวดล้อม
- โทเค็นบัญชีบริการ (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)

เปิดไฟล์การกำหนดค่า Claude Desktop ที่อยู่ที่:
- บน macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- บน Windows: %APPDATA%/Claude/claude_desktop_config.json
เพิ่มรายการเซิร์ฟเวอร์ mcp-hydrolix ลงในบล็อกการกำหนดค่า mcpServers เพื่อใช้ชื่อผู้ใช้และรหัสผ่าน:

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

ในการกำหนดค่าเซิร์ฟเวอร์ Hydrolix MCP สำหรับ Claude Code ให้รันคำสั่งต่อไปนี้:

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 (แนะนำ): URL สาธารณะมาตรฐานของคลัสเตอร์ Hydrolix ของคุณ เช่น https://mycluster.hydrolix.live สำหรับการปรับใช้นอกคลัสเตอร์ทั่วไป ตัวแปรเดียวนี้เพียงพอ — มันให้โฮสต์ พอร์ต (ค่าเริ่มต้นของสคีมา 443/80) และการตั้งค่า TLS สำหรับทั้งปลายทางคิวรี HTTP และโพรบ REST /version
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: แทนที่ปลายทางคิวรี HTTP ของ ClickHouse
HYDROLIX_VERSION_API_HOST / HYDROLIX_VERSION_API_PORT / HYDROLIX_VERSION_API_SECURE: แทนที่ปลายทางโพรบ REST /version HYDROLIX_VERSION_API_SECURE สืบทอดจากค่าความปลอดภัยของ HTTP-query ที่แก้ไขแล้วตามค่าเริ่มต้น

ตัวแปรที่เลิกใช้แล้ว

สิ่งต่อไปนี้ยังคงได้รับการยอมรับในช่วงการเปลี่ยนผ่าน แต่จะถูกลบออกในรุ่นอนาคต โยกย้ายตามความสะดวกของคุณ:

เลิกใช้แล้ว	การแทนที่
`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 Inspector
HYDROLIX_MCP_BIND_HOST: โฮสต์ที่จะผูกเซิร์ฟเวอร์ MCP เมื่อใช้การขนส่งแบบ HTTP หรือ SSE
- ค่าเริ่มต้น: "127.0.0.1"
- ตั้งเป็น "0.0.0.0" เพื่อผูกกับอินเทอร์เฟซเครือข่ายทั้งหมด (มีประโยชน์สำหรับ Docker หรือการเข้าถึงระยะไกล)
- ใช้เฉพาะเมื่อการขนส่งเป็น "http" หรือ "sse"
HYDROLIX_MCP_BIND_PORT: พอร์ตที่จะผูกเซิร์ฟเวอร์ MCP เมื่อใช้การขนส่งแบบ HTTP หรือ SSE
- ค่าเริ่มต้น: "8000"
- ใช้เฉพาะเมื่อการขนส่งเป็น "http" หรือ "sse"
HYDROLIX_MAX_RAW_TIMERANGE: ช่วงเวลาสูงสุดเป็นวินาทีที่อนุญาตสำหรับการคิวรีกับตารางที่ไม่ใช่ตารางสรุป
- ค่าเริ่มต้น: 21600 (6 ชั่วโมง)
- การคิวรีที่กำหนดเป้าหมายไปยังตารางสรุปจะไม่ได้รับผลกระทบจากขีดจำกัดนี้

สำหรับ MCP Inspector หรือการเข้าถึงระยะไกลด้วยการขนส่งแบบ 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 ในเครื่อง

ตัวอย่างการกำหนดค่า mcpServers ที่เชื่อมต่อกับเซิร์ฟเวอร์ HTTP ระยะไกลด้วยการตรวจสอบสิทธิ์ต่อคำขอ:

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

ตัวอย่างการกำหนดค่า .env แบบน้อยที่สุดสำหรับการรันเซิร์ฟเวอร์ HTTP ของคุณเองโดยไม่มีข้อมูลประจำตัวตามสภาพแวดล้อม:

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

แม้ว่าจะไม่ได้เป็นส่วนหนึ่งของข้อกำหนด MCP แต่ไคลเอนต์ MCP จำนวนมากอนุญาตให้เพิ่มส่วนหัวไปยังคำขอที่ออกโดย MCP เมื่อเป็นไปได้ เราแนะนำให้กำหนดค่าไคลเอนต์ MCP ให้ส่งโทเค็นบัญชีบริการผ่านส่วนหัว Authorization: Bearer <sa-token-here> แทนที่จะเป็นพารามิเตอร์คิวรีเพื่อความปลอดภัยที่มากขึ้น

หมายเหตุ: การตั้งค่าโฮสต์และพอร์ตที่ผูกจะใช้เฉพาะเมื่อตั้งค่าการขนส่งเป็น "http" หรือ "sse" เท่านั้น

การทดสอบแบบครบวงจร

ชุดการทดสอบแยกต่างหากภายใต้ tests/e2e/ จะปรับใช้ทรีการทำงานในเครื่องไปยังคลัสเตอร์ Hydrolix Kubernetes ที่ใช้งานจริง และทำการทดสอบควันกับเครื่องมือ MCP กับพ็อดที่กำลังทำงาน ชุดนี้ถูกแยกออกจากการรันทดสอบเริ่มต้นและจากฮุกก่อนพุช การรันต้องเลือกเข้าร่วมอย่างชัดเจนผ่านมาร์กเกอร์ pytest end_to_end พร้อมกับข้อมูลประจำตัว ดู tests/e2e/README.md สำหรับรันบุ๊ก