MCP server สำหรับหน่วยความจำของเอเจนต์: เชื่อมต่อ Claude Code กับ HotKV

MCP server เป็นวิธีที่ง่ายที่สุดในการให้ผู้ช่วย AI มีหน่วยความจำที่อยู่นานกว่าหนึ่งแชต Claude Code, Cursor และไคลเอนต์ที่คล้ายกันเสียบริบทของแชตเมื่อแชตจบ การให้เข้าถึงฐานข้อมูลดิบเพื่อแก้ปัญหานี้มีความเสี่ยง hotkv-mcp คือ MCP server โอเพนซอร์สของเราสำหรับ HotKV มันให้ผู้ช่วยมีชุดเครื่องมือตายตัวสำหรับโน้ต ประวัติบทสนทนา ล็อกเหตุการณ์ เทมเพลตพรอมต์ และการค้นหาเอกสาร และไม่ให้อะไรอย่างอื่น

สรุปสั้นๆ hotkv-mcp เป็น MCP server แบบ Apache-2.0 ที่เชื่อม Claude Code, Cursor, VS Code หรือเอเจนต์ของคุณเองเข้ากับเซิร์ฟเวอร์ HotKV ผ่านเครื่องมือตายตัว 28 ตัว ไม่มีเครื่องมือที่รันคำสั่งตามอำเภอใจ ผู้ช่วยจึงล้างข้อมูลหรือเปลี่ยนการกำหนดค่าไม่ได้ โหมดอ่านอย่างเดียวถอดเครื่องมือเขียนทุกตัวออก และ namespace จำกัดเอเจนต์ไว้ที่พรีฟิกซ์คีย์เดียว ติดตั้งด้วย pip install hotkv-mcp หรือรันด้วย uvx

Model Context Protocol คืออะไร

Model Context Protocol หรือ MCP เป็นมาตรฐานเปิดสำหรับเชื่อมต่อแอปพลิเคชัน AI เข้ากับระบบภายนอก เช่น แหล่งข้อมูล เครื่องมือ และเวิร์กโฟลว์ บทแนะนำของโปรเจกต์เปรียบมันกับพอร์ต USB-C สำหรับแอปพลิเคชัน AI ในภาษาของ MCP แอปพลิเคชันคือไคลเอนต์ และแต่ละระบบที่มันเชื่อมต่อถูกเปิดให้ใช้โดยเซิร์ฟเวอร์

สำหรับหน่วยความจำ นั่นหมายความว่าผู้ช่วยเรียกเครื่องมือที่มีชื่อ เช่นตัวที่บันทึกโน้ต เซิร์ฟเวอร์เป็นผู้ตัดสินว่าเครื่องมือนั้นทำอะไรได้บ้าง โมเดลไม่เคยได้การเชื่อมต่อฐานข้อมูลของตัวเอง

HotKV MCP server เปิดให้ใช้อะไรบ้าง

เซิร์ฟเวอร์ห่อหน่วยความจำของเอเจนต์ prompt registry และการค้นหาเอกสารของ HotKV ไว้ในเครื่องมือ 28 ตัว แต่ละเครื่องมือประกาศใน annotation ของ MCP ว่ามันอ่านอย่างเดียว เขียน หรือลบ ไคลเอนต์จึงขอการอนุมัติก่อนเครื่องมือที่ทำลายข้อมูลได้

เครื่องมือหน่วยความจำสอดคล้องกับที่เก็บที่อธิบายไว้ในหน่วยความจำของเอเจนต์ AI คือประวัติบทสนทนา โน้ตการทำงาน และล็อกเหตุการณ์ ไม่ได้เปิดการดึงข้อมูลเชิงความหมายด้วย embedding rag_search จัดอันดับตามความเกี่ยวข้องของคีย์เวิร์ด จึงไม่ต้องใช้ embedding

เครื่องมือคีย์ แฮช และลิสต์ใช้ได้กับเซิร์ฟเวอร์ HotKV ใดก็ได้ ส่วนเครื่องมือหน่วยความจำ พรอมต์ และการค้นหาเอกสารใช้เอนจิน AI ของ HotKV ซึ่งต้องมีไลเซนส์ที่รวมเอนจินเหล่านั้น หากไม่มี เครื่องมือเหล่านั้นจะคืนข้อความว่าเซิร์ฟเวอร์ไม่ได้รับไลเซนส์สำหรับฟีเจอร์นี้ เครื่องมือคีย์ยังใช้งานได้ อินสแตนซ์ HotKV Cloud แผน Performance และ Scale รวมเอนจิน AI ไว้แล้ว ตามที่หน้า AIอธิบาย

ติดตั้งและเชื่อมต่อ

เซิร์ฟเวอร์ต้องใช้ Python 3.10 ขึ้นไป เขียนขึ้นกับ HotKV server 0.3.0 และแพ็กเกจ hotkv-client ทางการ และเวอร์ชัน 1.0.0 อยู่บน PyPI ติดตั้งด้วย pip หรือรันโดยไม่ต้องติดตั้งด้วย uv

pip install hotkv-mcp
uvx hotkv-mcp --url hotkv://localhost:6379

Claude Code

เพิ่มด้วยคำสั่งเดียว -- แยกตัวเลือกของ Claude Code เองออกจากคำสั่งที่เริ่มเซิร์ฟเวอร์ ตามที่เอกสาร MCP ของ Claude Code อธิบาย

claude mcp add hotkv -- uvx hotkv-mcp --url hotkv://localhost:6379

Cursor และ Claude Desktop

ไคลเอนต์ที่อ่านไฟล์ mcpServers รับเซิร์ฟเวอร์เดียวกันเป็นรายการ JSON เก็บรหัสผ่านไว้ในตัวแปรสภาพแวดล้อม HOTKV_URL หรือที่เก็บความลับของไคลเอนต์ ผู้ใช้อื่นของเครื่องเห็นบรรทัดคำสั่งได้ ใช้ hotkvs:// สำหรับการเชื่อมต่อ TLS

{
  "mcpServers": {
    "hotkv": {
      "command": "uvx",
      "args": ["hotkv-mcp", "--read-only"],
      "env": { "HOTKV_URL": "hotkv://:your-password@localhost:6379" }
    }
  }
}

ตรวจว่าใช้งานได้

รัน claude mcp list เพื่อยืนยันว่าเซิร์ฟเวอร์ถูกลงทะเบียนแล้ว จากนั้นขอให้ผู้ช่วยเรียกเครื่องมือ server_info มันคืนเวอร์ชัน HotKV และการใช้หน่วยความจำ พร้อมจำนวนคีย์เมื่อไม่ได้ตั้ง namespace และยังรายงานว่าเซิร์ฟเวอร์เป็นแบบอ่านอย่างเดียวหรือไม่ และถูกจำกัดอยู่ใน namespace ใด นั่นยืนยันว่ามาตรการป้องกันของคุณมีผลแล้ว

ให้เอเจนต์อยู่ในขอบเขตที่ปลอดภัย

โมเดลที่เรียกเครื่องมือได้ก็ถูกชักจูงให้ใช้เครื่องมือผิดวัตถุประสงค์ได้เช่นกัน ขอบเขตจึงสำคัญกว่าฟีเจอร์

ไม่มีคำสั่งตามอำเภอใจ

ไม่มีเครื่องมือที่รันคำสั่งดิบ ผู้ช่วยล้างฐานข้อมูลหรือเปลี่ยนการกำหนดค่าของเซิร์ฟเวอร์ไม่ได้ เพราะเครื่องมือทั้ง 28 ตัวไม่ได้ทำสิ่งเหล่านั้น มันอ่านคีย์ใดก็ได้ที่เครื่องมือเข้าถึง ซึ่งเป็นเหตุผลที่ namespace ด้านล่างสำคัญ

โหมดอ่านอย่างเดียว

--read-only ถอดเครื่องมือทุกตัวที่เขียน รวมถึง set, delete, hash_set, list_push เครื่องมือหน่วยความจำที่เพิ่มหรือล้าง prompt_save, rag_create และ rag_ingest เอเจนต์แม้แต่มองไม่เห็นมัน ใช้กับผู้ช่วยที่ควรอ้างอิงหน่วยความจำแต่ไม่เปลี่ยนมันเลย

Namespace และเพดานขนาด

--namespace PREFIX เก็บทุกอย่างไว้ใต้พรีฟิกซ์นั้น เอเจนต์ไม่เห็นพรีฟิกซ์และเข้าถึงชื่ออื่นไม่ได้ ให้เอเจนต์แต่ละตัวมีพรีฟิกซ์ที่ไม่ใช่ส่วนต้นของพรีฟิกซ์ของตัวอื่น ใช้ agent-a และ agent-b ไม่ใช่ agent และ agent:b ไม่เช่นนั้นตัวที่สั้นกว่าจะเข้าถึงชื่อของตัวที่ยาวกว่าได้

ผลลัพธ์ก็มีเพดานด้วย --max-value-bytes ตัดค่าที่ยาวและทำเครื่องหมายว่าถูกตัด โดยค่าเริ่มต้นคือ 65,536 ไบต์ --max-items จำกัดจำนวนคีย์ รายการในลิสต์ หรือผลที่พบที่การเรียกหนึ่งครั้งคืนมา โดยค่าเริ่มต้นคือ 200 ค่าขนาดมหึมาเพียงค่าเดียวจึงท่วมบริบทของโมเดลไม่ได้ การอ่านทั้งแฮชไม่ถูกจำกัดจำนวนรายการ จึงควรเก็บแฮชขนาดใหญ่ไว้นอก namespace ของเอเจนต์

การขนส่งผ่าน HTTP ไม่มีการล็อกอิน

การขนส่งแบบ stdio เริ่มต้นถูกไคลเอนต์เริ่มเป็นโปรเซสย่อย สำหรับการใช้ร่วมกัน คุณรัน hotkv-mcp --transport streamable-http ได้ ซึ่งรับฟังที่ 127.0.0.1:8000 ที่ /mcp มันไม่ยืนยันตัวตนผู้เรียก ให้คงไว้บน localhost หรือวางไว้หลังรีเวิร์สพร็อกซีที่ยืนยันตัวตน และกำหนด namespace ของมันเอง

เลือกการตั้งค่าสำหรับทีม

แฟล็กที่เหมาะสมขึ้นอยู่กับว่าเอเจนต์แต่ละตัวมีไว้ทำอะไร ทุกตัวเลือกด้านล่างเป็นแฟล็กบรรทัดคำสั่ง --read-only และ --namespace ยังมีตัวแปรสภาพแวดล้อม คือ HOTKV_MCP_READ_ONLY และ HOTKV_MCP_NAMESPACE

เริ่มจากแถวที่จำกัดที่สุดที่ทำงานได้ การขยายสิทธิ์ภายหลังทำได้ง่าย แต่การเอาคืนสิ่งที่เอเจนต์เขียนไปแล้วทำได้ยาก

เซสชันแรก ทีละขั้นตอน

การทดลองสั้นๆ แสดงว่ามาตรการป้องกันทำอะไร ก่อนที่คุณจะไว้ใจเซิร์ฟเวอร์กับโน้ตจริง ใช้ namespace ชั่วคราวและเซิร์ฟเวอร์ HotKV ในเครื่องที่มีไลเซนส์สำหรับเอนจิน AI เพราะเครื่องมือหน่วยความจำใช้ไม่ได้หากไม่มีไลเซนส์นั้น

1. เชื่อมต่อด้วย namespace รัน claude mcp add hotkv -- uvx hotkv-mcp --url hotkv://localhost:6379 --namespace trial
2. ตรวจขอบเขต ขอให้ผู้ช่วยเรียก server_info แล้วรายงาน namespace และบอกว่าเซิร์ฟเวอร์เป็นแบบอ่านอย่างเดียวหรือไม่ มันควรตอบ trial และไม่ใช่อ่านอย่างเดียว
3. บันทึกโน้ต ขอให้มันจำว่าไซต์ staging อยู่ที่ที่อยู่หนึ่ง ภายใต้โน้ตที่ตั้งชื่อตามไซต์ ผู้ช่วยเรียก memory_set_note และเซสชันถูกสร้างเมื่อใช้ครั้งแรก
4. อ่านกลับในแชตใหม่ เริ่มบทสนทนาใหม่และถามว่ามีโน้ตอะไรสำหรับเซสชันนั้น มันเรียก memory_list_notes และ memory_get_note และโน้ตยังอยู่
5. บันทึกการตัดสินใจ ขอให้มันบันทึกการตัดสินใจในล็อกเหตุการณ์ มันเรียก memory_log_event และ memory_query_events นำมันกลับมาภายหลัง
6. ถอดสิทธิ์เขียน ลบรายการเดิม เชื่อมต่อใหม่ด้วย --read-only แล้วทำขั้นที่ 4 ซ้ำ การอ่านยังใช้ได้ และเครื่องมือที่เขียนไม่ถูกเสนออีก

หากขั้นที่ 6 ทำงานตามที่อธิบาย คุณก็ได้เห็นการควบคุมสองอย่างที่สำคัญที่สุดแล้ว คือ namespace และโหมดอ่านอย่างเดียว

ปฏิบัติต่อสิ่งที่ผู้ช่วยเก็บไว้เหมือนข้อความที่ไม่น่าเชื่อถือเมื่ออ่านกลับ ตามที่บทความเรื่องหน่วยความจำอธิบายในปฏิบัติต่อข้อความที่เก็บไว้เหมือนไม่น่าเชื่อถือ โน้ตที่เขียนจากหน้าเว็บอาจแฝงคำสั่ง

การแก้ปัญหา

• "This HotKV server is not licensed for that feature." เครื่องมือหน่วยความจำ พรอมต์ และการค้นหาเอกสารต้องใช้ไลเซนส์ HotKV ที่รวมเอนจิน AI เครื่องมือคีย์ แฮช และลิสต์ยังใช้ได้โดยไม่มีไลเซนส์
• การเชื่อมต่อล้มเหลว ตรวจสกีมของ URL hotkv://, hotkvs:// (TLS), redis:// และ rediss:// ใช้ได้ทั้งหมด และรหัสผ่านใส่ใน URL เป็น hotkv://:password@host:6379
• ค่าถูกตัด ผลลัพธ์ถูกทำเครื่องหมายว่าถูกตัดเมื่อเกิน --max-value-bytes เพิ่มขีดจำกัด หรือเก็บค่าที่เล็กลง
• เครื่องมือเขียนหายไป มองหา --read-only ในอาร์กิวเมนต์ของเซิร์ฟเวอร์ หรือ HOTKV_MCP_READ_ONLY ในสภาพแวดล้อมของมัน
• ผู้ช่วยหาชื่อที่เคยบันทึกไว้ไม่เจอ ตรวจว่ามันใช้ชื่อเซสชันหรือเอเจนต์เดียวกัน และเซิร์ฟเวอร์รันด้วย namespace เดียวกับก่อนหน้า
• ไม่พบ uvx ติดตั้ง uv หรือติดตั้งแพ็กเกจด้วย pip แล้วเริ่ม hotkv-mcp โดยตรง

คำถามที่พบบ่อย