Hydrolix

ทางการ

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

GitHub
11
ลองใช้ MCP นี้ผู้สนับสนุน

คุณทำอะไรได้บ้างด้วย Hydrolix MCP?

  • รันคิวรี SQL — ขอให้ผู้ช่วยของคุณดำเนินการ run_select_query กับคลัสเตอร์ Hydrolix ของคุณ โดยสามารถกำหนดขีดจำกัดจำนวนแถวและความคิดเห็นเกี่ยวกับวัตถุประสงค์ได้
  • แสดงรายการฐานข้อมูล — ให้ผู้ช่วยของคุณเรียกใช้ list_databases เพื่อแสดงฐานข้อมูลทั้งหมดที่มีอยู่ในคลัสเตอร์ Hydrolix ของคุณ
  • สำรวจโครงสร้างตาราง — ใช้ list_tables และ get_table_info เพื่อค้นหาตารางและดึงข้อมูลเมตาดาต้า เช่น โครงสร้าง (schema) สำหรับฐานข้อมูลใดก็ได้
  • คิวรีตามช่วงเวลา — ขอผลลัพธ์ที่เรียงตามลำดับเวลา (timestamp) ภายในช่วงวันที่ที่กำหนด เพื่อใช้ประโยชน์จากการปรับแต่งคีย์หลัก (primary key) สำหรับคิวรีที่มีประสิทธิภาพ

เอกสาร

เซิร์ฟเวอร์ MCP ของ Hydrolix

PyPI - Version Install in VS Code Install in VS Code Insiders

เซิร์ฟเวอร์ 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

  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) ให้ใช้ "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 — ตรวจสอบว่าทำงานถูกต้อง

  1. เปิดการสนทนาใหม่ใน Claude Desktop มองหาไอคอนเครื่องมือ/ค้อนใกล้กับช่องป้อนข้อความ — ซึ่งยืนยันว่าเซิร์ฟเวอร์ MCP เชื่อมต่อสำเร็จ

  2. ลองใช้พรอมต์นี้เพื่อยืนยันว่าทุกอย่างทำงาน:

    ใช้เครื่องมือ 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 แทนหรือไม่

คลิกป้าย ติดตั้งใน 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 ของคุณ
    • อินพุต: query (สตริง): การค้นหา SQL ที่จะดำเนินการ
    • อินพุต: max_cells (จำนวนเต็ม, ไม่บังคับ): งบประมาณเซลล์ผลลัพธ์ (แถว × คอลัมน์); เมื่อเซิร์ฟเวอร์ตั้งค่าขีดจำกัด ผู้เรียกสามารถลดได้เท่านั้น
    • อินพุต: purpose (สตริง, จำเป็น): เหตุผลที่รันการค้นหา; บันทึกพร้อมกับการค้นหาเป็น hdx_query_comment
    • ส่วนท้าย FORMAT จะถูกลบออก; เซิร์ฟเวอร์เลือกฟอร์แมตสายส่ง
  • list_databases

    • แสดงรายการฐานข้อมูลทั้งหมดบนคลัสเตอร์ Hydrolix ของคุณ
  • list_tables

    • แสดงรายการตารางทั้งหมดในฐานข้อมูล
    • อินพุต: database (สตริง): ชื่อของฐานข้อมูล
  • get_table_info

    • รับข้อมูลเมตาของตาราง เช่น โครงสร้าง
    • อินพุต: database (สตริง): ชื่อของฐานข้อมูล
    • อินพุต: table (สตริง): ชื่อของตาราง

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

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

  • อ้างถึงฐานข้อมูล 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

การกำหนดค่า

เซิร์ฟเวอร์ MCP ของ Hydrolix ถูกกำหนดค่าโดยใช้รายการเซิร์ฟเวอร์ MCP มาตรฐาน ปรึกษาเอกสารของไคลเอนต์ของคุณสำหรับคำแนะนำเฉพาะเกี่ยวกับตำแหน่งที่จะค้นหาหรือประกาศเซิร์ฟเวอร์ MCP ตัวอย่างการตั้งค่าโดยใช้ Claude Desktop มีเอกสารด้านล่าง

วิธีที่แนะนำในการเปิดใช้เซิร์ฟเวอร์ MCP ของ Hydrolix คือผ่าน ตัวจัดการโครงการ uv ซึ่งจะจัดการติดตั้ง dependencies อื่นๆ ทั้งหมดในสภาพแวดล้อมที่แยกจากกัน

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

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

  1. โทเค็น Bearer ต่อคำขอ: โทเค็นบัญชีบริการที่ให้ผ่านส่วนหัว Authorization: Bearer <token>
  2. พารามิเตอร์ GET ต่อคำขอ: โทเค็นบัญชีบริการที่ให้ผ่านพารามิเตอร์คิวรี ?token=<token>
  3. ข้อมูลประจำตัวตามสภาพแวดล้อม: ข้อมูลประจำตัวที่กำหนดค่าผ่านตัวแปรสภาพแวดล้อม
    • โทเค็นบัญชีบริการ (HYDROLIX_TOKEN) หรือ
    • ชื่อผู้ใช้และรหัสผ่าน (HYDROLIX_USER และ HYDROLIX_PASSWORD)

เมื่อกำหนดค่าวิธีการตรวจสอบสิทธิ์หลายวิธี เซิร์ฟเวอร์จะใช้วิธีแรกที่พร้อมใช้งานตามลำดับความสำคัญข้างต้น การตรวจสอบสิทธิ์ต่อคำขอใช้ได้เฉพาะเมื่อใช้โหมดการขนส่ง HTTP หรือ SSE ฟอร์ม ?token= มีไว้สำหรับไคลเอนต์ที่ไม่สามารถส่งส่วนหัวได้; ตั้งค่า HYDROLIX_ALLOW_TOKEN_QUERY_PARAM=false ในการปรับใช้ที่ไคลเอนต์ทุกตัวส่งส่วนหัว Authorization (ดู ข้อมูลประจำตัวต่อคำขอ)

หมายเหตุ: แนะนำให้ใช้โทเค็นบัญชีบริการที่มีบทบาทอ่านอย่างเดียว

คำจำกัดความของเซิร์ฟเวอร์ 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. เพิ่มรายการเซิร์ฟเวอร์ 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>"
      }
    }
  }
}
  1. อัปเดตคำจำกัดความของตัวแปรสภาพแวดล้อมเพื่อชี้ไปยังคลัสเตอร์ Hydrolix ของคุณ

  2. (แนะนำ) ค้นหารายการคำสั่งสำหรับ uvx และแทนที่ด้วยเส้นทางสัมบูรณ์ไปยังไฟล์ปฏิบัติการ uvx เพื่อให้แน่ใจว่าใช้เวอร์ชันที่ถูกต้องของ uvx เมื่อเริ่มเซิร์ฟเวอร์ คุณสามารถค้นหาเส้นทางนี้ได้โดยใช้ which uvx หรือ where.exe uvx

  3. รีสตาร์ท Claude Desktop เพื่อใช้การเปลี่ยนแปลง หากคุณใช้ Windows ตรวจสอบให้แน่ใจว่า Claude หยุดโดยสมบูรณ์โดยปิดไคลเอนต์ผ่านไอคอนถาดระบบ

ตัวอย่างการกำหนดค่า (Claude Code)

เพื่อกำหนดค่าเซิร์ฟเวอร์ MCP ของ Hydrolix สำหรับ 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 สำหรับการปรับใช้นอกคลัสเตอร์โดยทั่วไป ตัวแปรเดียวนี้เพียงพอ — ให้โฮสต์ พอร์ต (ค่าเริ่มต้นตาม scheme 443/80) และการตั้งค่า TLS สำหรับทั้งปลายทางคิวรี HTTP และการตรวจสอบ /version ของ REST
  • 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 ในเครื่อง

ตัวอย่างการกำหนดค่า 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"

ตัวแปรที่ไม่บังคับ

ดู docs/CONFIG.md สำหรับการแทนที่ปลายทาง ตัวแปรนามแฝงที่เลิกใช้แล้ว และชุดตัวแปรปรับแต่งที่ไม่บังคับทั้งหมด (การหมดเวลา การแทนที่การตั้งค่า SETTINGS ของคิวรี การตัดทอนผลลัพธ์ การปรับแต่ง worker HTTP/SSE พร็อกซี เมตริก และช่องทางหลบหนี)

ผู้ดูแล

งานที่ต้องใช้สิทธิ์การปฏิบัติการ — การรันชุดทดสอบแบบ end-to-end กับคลัสเตอร์ Hydrolix ที่ใช้งานจริง และการตัดเวอร์ชันเผยแพร่ — ได้ถูกบันทึกแยกไว้ใน MAINTAINERS.md