ต้นแบบ · รุ่นทดลอง: มีทุก server ในทะเบียนทางการ อัปเดตทุก 30 นาที เข้าสู่ระบบด้วย Google เพื่อเขียนรีวิวได้แล้วต้นแบบ · อัปเดตทุก 30 นาที
PopNx MCPที่รวม MCP สำหรับคนใช้ AI · วิธีติดตั้งภาษาไทยทุกตัว เข้าสู่ระบบ

Homelab Infra MCP

โดย seayniclabsรุ่น 2.1.1i★ 0iรันบนเครื่องหน้า repo ↗
ชื่อใน registryio.github.seayniclabs/homelab-infra-mcp

วิธีติดตั้ง

ใช้ทำอะไรได้

ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ

  • ต่อแบบ ติดตั้งในเครื่อง
  • บัญชีหรือคีย์ ต้องมี HOMELAB_PROXY_PASSWORD, HOMELAB_DOCKER_PORTAINER_TOKEN, HOMELAB_DNS_API_TOKEN, HOMELAB_HOME_ASSISTANT_TOKEN, HOMELAB_UPTIME_API_KEY, HOMELAB_TUNNEL_API_TOKEN, HOMELAB_DNS_FILTER_PASSWORD, HOMELAB_SSO_TOKEN
  • หมวด เครื่องมือนักพัฒนา
คำอธิบายต้นฉบับจากผู้ทำ (อังกฤษ)
Homelab: Nginx Proxy Manager, Docker and Cloudflare DNS, with approval for every change.

ใช้คู่กับ

Skill ที่สอน AI ทำงานแบบนี้ ใช้ร่วมกับตัวนี้ได้

rea

rea เป็นเครื่องมือเสริมสำหรับ AI agent ใช้ทำ reverse engineering กับสิ่งต่าง ๆ ตั้งแต่พฤติกรรมของแอปพลิเคชันไปจนถึงไบนารีระดับ native

โดย morluto★ 468,7331 skill

Skill · คู่มือ

andrej-karpathy-skills

andrej-karpathy-skills เป็นไฟล์ CLAUDE.md ไฟล์เดียวที่ใช้ปรับพฤติกรรมของ Claude Code ให้ดีขึ้น โดยอ้างอิงจากข้อสังเกตของ Andrej Karpathy เกี่ยวกับข้อผิดพลาดที่พบบ่อยเมื่อ LLM เขียนโค้ด

โดย multica-ai★ 234,3321 skill

Skill · คู่มือไม่ระบุสัญญาอนุญาต

graphify

graphify เป็นเครื่องมือที่แปลงโค้ด เอกสาร สคีมา SQL คอนฟิก และไฟล์ PDF ให้เป็นกราฟความรู้ที่ค้นหาได้ ทำงานแบบ local ผ่านการแยกโครงสร้าง AST และใช้ได้กับ Claude Code, Cursor, Codex และ Gemini CLI

โดย Graphify-Labs★ 150,2871 skill

Skill · คู่มือ

ทำไมอยู่อันดับนี้

หน้ารายการเรียงด้วยคะแนนการใช้งาน (เต็ม 100) จากส่วนเหล่านี้

ความนิยม0/80ดาว GitHub หรือยอดดาวน์โหลดต่อสัปดาห์ ค่ามากนับ 60 ค่าน้อยนับ 20
ความสด12/12ออกรุ่นหรือแก้โค้ดใน 30 วัน ได้เต็ม
ระบบยังตอบ0/8endpoint บนคลาวด์ตอบตอนตรวจล่าสุด
คะแนนการใช้งาน12/100

คุณภาพ: ผลตรวจเบื้องต้นผ่าน 3/3 ข้อ (แสดงให้ดู ไม่ได้ใช้เรียง) · ความมาแรง: ยังไม่มีข้อมูล (ใช้เรียงเฉพาะแท็บมาแรง)

ติดตั้ง

เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง

ให้ AI ติดตั้งให้ด้วยประโยคเดียว

ติดตั้ง Homelab Infra MCP ให้หน่อย ทำตาม https://mcp.popnx.com/i/seayniclabs-homelab-infra-mcp.md แสดงคำสั่งให้ฉันดูและรอฉันตกลงก่อนรัน

คัดลอกไปวางในแชตของ AI ที่ทำงานในเครื่องคุณได้ (เช่น Claude Code, Cursor) · AI จะอ่านขั้นตอนจากเรา แสดงคำสั่งให้ดู และรอคุณตกลงก่อน · ไม่ต้องใช้คีย์ ไม่ต้องสมัคร · ดูข้อความเต็มที่ AI จะอ่าน

ผลตรวจผ่าน 3/3 · ทำงานบนเครื่องคุณ · ✓ ตรวจคำสั่งแล้ว 14 พ.ย. 2569

ขั้นแรก: คุณใช้ AI ตัวไหน

เลือกแอปที่คุณใช้ ขั้นตอนจะขึ้นด้านล่าง

ต่อกับ Claude ได้ แต่ต้องเตรียมก่อน

ต้องมีคีย์ของ Homelab Infra MCP (สร้างที่เว็บของผู้ทำ) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว) · ใช้ได้เฉพาะแอป Claude บนคอม (Windows หรือ Mac) ไม่ใช่บนเว็บหรือมือถือ

ให้ AI ติดตั้งให้

คัดลอกข้อความนี้ไปวางในแชตของ Claude AI จะเช็กเครื่อง บอกว่าจะแก้ไฟล์ไหน และรอคุณตกลงก่อนทุกครั้ง

ช่วยติดตั้ง MCP server ชื่อ Homelab Infra MCP ให้ Claude ในเครื่องนี้ ทำตามลำดับ 1) เช็กว่ามี uv ด้วยคำสั่ง uv --version ถ้าไม่มี ให้บอกฉันไปลงจาก https://docs.astral.sh/uv/getting-started/installation/ ห้ามลงเอง 2) ใช้คอนฟิกนี้เท่านั้น (ผ่านตัวตรวจของ PopNx MCP แล้ว): { "mcpServers": { "homelab-infra": { "command": "uvx", "args": [ "homelab-infra-mcp" ], "env": { "HOMELAB_PROXY_PASSWORD": "ใส่ค่าของคุณ", "HOMELAB_DOCKER_PORTAINER_TOKEN": "ใส่ค่าของคุณ", "HOMELAB_DNS_API_TOKEN": "ใส่ค่าของคุณ", "HOMELAB_HOME_ASSISTANT_TOKEN": "ใส่ค่าของคุณ", "HOMELAB_UPTIME_API_KEY": "ใส่ค่าของคุณ", "HOMELAB_TUNNEL_API_TOKEN": "ใส่ค่าของคุณ", "HOMELAB_DNS_FILTER_PASSWORD": "ใส่ค่าของคุณ", "HOMELAB_SSO_TOKEN": "ใส่ค่าของคุณ" } } } } 3) บอก path เต็มของไฟล์ที่จะแก้ หรือคำสั่งที่จะรัน แล้วรอฉันตกลงก่อน 4) ช่อง HOMELAB_PROXY_PASSWORD, HOMELAB_DOCKER_PORTAINER_TOKEN, HOMELAB_DNS_API_TOKEN, HOMELAB_HOME_ASSISTANT_TOKEN, HOMELAB_UPTIME_API_KEY, HOMELAB_TUNNEL_API_TOKEN, HOMELAB_DNS_FILTER_PASSWORD, HOMELAB_SSO_TOKEN ให้คงคำว่า "ใส่ค่าของคุณ" ไว้ก่อน แล้วบอกให้ฉันวางค่าจริงเองในไฟล์หรือช่องของแอป ห้ามขอให้ฉันพิมพ์คีย์ในแชต 5) ทำตามที่ตกลง แล้วตรวจว่าเครื่องมือของ Homelab Infra MCP ขึ้นจริง

ข้อความนี้ไม่มีคีย์ของคุณ ถ้าต้องใช้คีย์ AI จะบอกให้คุณวางเองในไฟล์หรือช่องของแอป

  1. ลง uv ในเครื่อง (ถ้ายังไม่มี)

    ลงไว้แล้วหรือยัง? เช็กก่อน · เปิด Terminal แล้วพิมพ์คำสั่งนี้ กด Enter

    uv --version
    • ขึ้นเลขรุ่น เช่น uv … = ลงแล้ว ข้ามขั้นนี้ได้
    • ขึ้นว่า "command not found" (Windows ขึ้นว่า "is not recognized") = ยังไม่ได้ลง หรือเพิ่งลงแต่ยังไม่ได้ปิดแล้วเปิด Terminal ใหม่
    เปิด Terminal ยังไง

    Mac: กด ⌘ + Space พิมพ์ Terminal แล้วกด Enter

    Windows: เปิดเมนู Start พิมพ์ Windows PowerShell แล้วกด Open

    ยังไม่ได้ลง: uv ไม่มีตัวติดตั้งแบบกดเอง คัดลอกคำสั่งหนึ่งบรรทัดของเครื่องคุณ (macOS หรือ Windows) จากหน้าทางการของ uv ไปวางใน Terminal · ไม่ต้องลง Python แยก uv ดาวน์โหลดให้เองเมื่อต้องใช้

    เปิดหน้าดาวน์โหลด uv ↗

    ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น: uv --version

    ลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ uv

  2. สมัครและสร้างคีย์ของ Homelab Infra MCP

    เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ

    วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง

  3. เปิดไฟล์ตั้งค่าของแอป Claude บนคอม

    SettingsDeveloperEdit Config

  4. วางค่าตั้งนี้แล้วบันทึกไฟล์

    {
      "mcpServers": {
        "homelab-infra": {
          "command": "uvx",
          "args": [
            "homelab-infra-mcp"
          ],
          "env": {
            "HOMELAB_PROXY_PASSWORD": "ใส่ค่าของคุณ",
            "HOMELAB_DOCKER_PORTAINER_TOKEN": "ใส่ค่าของคุณ",
            "HOMELAB_DNS_API_TOKEN": "ใส่ค่าของคุณ",
            "HOMELAB_HOME_ASSISTANT_TOKEN": "ใส่ค่าของคุณ",
            "HOMELAB_UPTIME_API_KEY": "ใส่ค่าของคุณ",
            "HOMELAB_TUNNEL_API_TOKEN": "ใส่ค่าของคุณ",
            "HOMELAB_DNS_FILTER_PASSWORD": "ใส่ค่าของคุณ",
            "HOMELAB_SSO_TOKEN": "ใส่ค่าของคุณ"
          }
        }
      }
    }

    วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร

  5. ปิดแอป Claude แล้วเปิดใหม่

  6. ลองเลย

    ใช้ Homelab Infra MCP บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า Claude บอกว่ากำลังใช้ Homelab Infra MCP หรือมีชื่อเครื่องมือของ Homelab Infra MCP ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ค่าตั้งเพิ่มเติม 19 ช่อง (ไม่ต้องกรอกก็ใช้ได้)

คำสั่งด้านบนใช้ได้เลยโดยไม่ต้องใส่ค่าเหล่านี้ ถ้าอยากปรับค่อยเพิ่มเองตามคำอธิบายของผู้ทำ

  • HOMELAB_PROXY_URL ที่อยู่ของ Nginx Proxy Manager เช่น http://localhost:81
    ดูต้นฉบับภาษาอังกฤษNginx Proxy Manager address, e.g. http://localhost:81
  • HOMELAB_PROXY_EMAIL อีเมลผู้ดูแลระบบของ Nginx Proxy Manager
    ดูต้นฉบับภาษาอังกฤษNginx Proxy Manager admin email
  • HOMELAB_DOCKER_HOST ที่อยู่ของ Docker engine เช่น unix:///var/run/docker.sock
    ดูต้นฉบับภาษาอังกฤษDocker engine address, e.g. unix:///var/run/docker.sock
  • HOMELAB_DOCKER_PORTAINER_URL URL พื้นฐานของ Portainer ใช้แทน Docker socket
    ดูต้นฉบับภาษาอังกฤษPortainer base URL, instead of the Docker socket
  • HOMELAB_DOCKER_PORTAINER_ENDPOINT_ID รหัส endpoint ของ Portainer (ค่าเริ่มต้น 1)
    ดูต้นฉบับภาษาอังกฤษPortainer endpoint id (default 1)
  • HOMELAB_DNS_ZONE_ID รหัส zone ของ Cloudflare เริ่มต้น
    ดูต้นฉบับภาษาอังกฤษDefault Cloudflare zone id
  • HOMELAB_HOME_ASSISTANT_URL ที่อยู่ของ Home Assistant (โมดูลนี้ปิดอยู่โดยค่าเริ่มต้น)
    ดูต้นฉบับภาษาอังกฤษHome Assistant address (module is off by default)
  • HOMELAB_UPTIME_ENABLED true เปิดใช้งานโมดูล Uptime Kuma (ปิดเป็นค่าเริ่มต้น)
    ดูต้นฉบับภาษาอังกฤษtrue turns on the Uptime Kuma module (off by default)
  • HOMELAB_UPTIME_URL ที่อยู่ของ Uptime Kuma
    ดูต้นฉบับภาษาอังกฤษUptime Kuma address
  • HOMELAB_TUNNEL_ENABLED true เปิดใช้งานโมดูล Cloudflare Tunnel (ปิดเป็นค่าเริ่มต้น)
    ดูต้นฉบับภาษาอังกฤษtrue turns on the Cloudflare Tunnel module (off by default)
  • HOMELAB_TUNNEL_ACCOUNT_ID รหัสบัญชี Cloudflare ที่เป็นเจ้าของ tunnel
    ดูต้นฉบับภาษาอังกฤษCloudflare account id that owns the tunnel
  • HOMELAB_TUNNEL_TUNNEL_ID รหัส Cloudflare Tunnel
    ดูต้นฉบับภาษาอังกฤษCloudflare Tunnel id
  • HOMELAB_DNS_FILTER_ENABLED true เปิดใช้งานโมดูล AdGuard Home (ปิดไว้เป็นค่าเริ่มต้น)
    ดูต้นฉบับภาษาอังกฤษtrue turns on the AdGuard Home module (off by default)
  • HOMELAB_DNS_FILTER_URL ที่อยู่ของ AdGuard Home
    ดูต้นฉบับภาษาอังกฤษAdGuard Home address
  • HOMELAB_DNS_FILTER_USERNAME ชื่อผู้ใช้ของ AdGuard Home
    ดูต้นฉบับภาษาอังกฤษAdGuard Home login
  • HOMELAB_SSO_ENABLED true เปิดใช้งานโมดูล Authentik (ปิดไว้เป็นค่าเริ่มต้น)
    ดูต้นฉบับภาษาอังกฤษtrue turns on the Authentik module (off by default)
  • HOMELAB_SSO_URL ที่อยู่ของ Authentik
    ดูต้นฉบับภาษาอังกฤษAuthentik address
  • HOMELAB_SSO_FLOW_SLUG slug ของโฟลว์การอนุญาตของ Authentik ที่ใช้กับผู้ให้บริการพร็อกซีใหม่
    ดูต้นฉบับภาษาอังกฤษAuthentik authorization flow slug used for new proxy providers
  • HOMELAB_READ_ONLY true จะปฏิเสธทุกการเปลี่ยนแปลง
    ดูต้นฉบับภาษาอังกฤษtrue refuses every change

คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ChatGPT ยังต่อ Homelab Infra MCP ไม่ได้

Homelab Infra MCP ต้องติดตั้งในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะตัวที่ทำงานบนเว็บ

คุณทำแบบนี้แทนได้

ก · ใช้แอปที่ต่อ Homelab Infra MCP ได้

  • ต้องมีคีย์ของ Homelab Infra MCP (สร้างที่เว็บของผู้ทำ) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว) · ใช้ได้เฉพาะแอป Claude บนคอม (Windows หรือ Mac) ไม่ใช่บนเว็บหรือมือถือ
  • ต้องมีคีย์ของ Homelab Infra MCP (สร้างที่เว็บของผู้ทำ) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)
  • ต้องมีคีย์ของ Homelab Infra MCP (สร้างที่เว็บของผู้ทำ) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)
  • ต้องมีคีย์ของ Homelab Infra MCP (สร้างที่เว็บของผู้ทำ) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)

ข · ตัวอื่นในหมวด เครื่องมือนักพัฒนา ที่ต่อกับ ChatGPT ได้

เลือกจากตัวที่ใช้มากในหมวดเดียวกัน เฉพาะตัวที่ต่อด้วยที่อยู่ได้โดยไม่ต้องใส่คีย์

ต่อกับ Claude Code ได้ แต่ต้องเตรียมก่อน

ต้องมีคีย์ของ Homelab Infra MCP (สร้างที่เว็บของผู้ทำ) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)

ให้ AI ติดตั้งให้

คัดลอกข้อความนี้ไปวางในแชตของ Claude Code AI จะเช็กเครื่อง บอกว่าจะแก้ไฟล์ไหน และรอคุณตกลงก่อนทุกครั้ง

ช่วยติดตั้ง MCP server ชื่อ Homelab Infra MCP ให้ Claude Code ในเครื่องนี้ ทำตามลำดับ 1) เช็กว่ามี uv ด้วยคำสั่ง uv --version ถ้าไม่มี ให้บอกฉันไปลงจาก https://docs.astral.sh/uv/getting-started/installation/ ห้ามลงเอง 2) ใช้คอนฟิกนี้เท่านั้น (ผ่านตัวตรวจของ PopNx MCP แล้ว): claude mcp add --scope user homelab-infra --env HOMELAB_PROXY_PASSWORD='ใส่ค่าของคุณ' --env HOMELAB_DOCKER_PORTAINER_TOKEN='ใส่ค่าของคุณ' --env HOMELAB_DNS_API_TOKEN='ใส่ค่าของคุณ' --env HOMELAB_HOME_ASSISTANT_TOKEN='ใส่ค่าของคุณ' --env HOMELAB_UPTIME_API_KEY='ใส่ค่าของคุณ' --env HOMELAB_TUNNEL_API_TOKEN='ใส่ค่าของคุณ' --env HOMELAB_DNS_FILTER_PASSWORD='ใส่ค่าของคุณ' --env HOMELAB_SSO_TOKEN='ใส่ค่าของคุณ' -- uvx homelab-infra-mcp 3) บอก path เต็มของไฟล์ที่จะแก้ หรือคำสั่งที่จะรัน แล้วรอฉันตกลงก่อน 4) ช่อง HOMELAB_PROXY_PASSWORD, HOMELAB_DOCKER_PORTAINER_TOKEN, HOMELAB_DNS_API_TOKEN, HOMELAB_HOME_ASSISTANT_TOKEN, HOMELAB_UPTIME_API_KEY, HOMELAB_TUNNEL_API_TOKEN, HOMELAB_DNS_FILTER_PASSWORD, HOMELAB_SSO_TOKEN ให้คงคำว่า "ใส่ค่าของคุณ" ไว้ก่อน แล้วบอกให้ฉันวางค่าจริงเองในไฟล์หรือช่องของแอป ห้ามขอให้ฉันพิมพ์คีย์ในแชต 5) ทำตามที่ตกลง แล้วตรวจว่าเครื่องมือของ Homelab Infra MCP ขึ้นจริง

ข้อความนี้ไม่มีคีย์ของคุณ ถ้าต้องใช้คีย์ AI จะบอกให้คุณวางเองในไฟล์หรือช่องของแอป

  1. ลง uv ในเครื่อง (ถ้ายังไม่มี)

    ลงไว้แล้วหรือยัง? เช็กก่อน · เปิด Terminal แล้วพิมพ์คำสั่งนี้ กด Enter

    uv --version
    • ขึ้นเลขรุ่น เช่น uv … = ลงแล้ว ข้ามขั้นนี้ได้
    • ขึ้นว่า "command not found" (Windows ขึ้นว่า "is not recognized") = ยังไม่ได้ลง หรือเพิ่งลงแต่ยังไม่ได้ปิดแล้วเปิด Terminal ใหม่
    เปิด Terminal ยังไง

    Mac: กด ⌘ + Space พิมพ์ Terminal แล้วกด Enter

    Windows: เปิดเมนู Start พิมพ์ Windows PowerShell แล้วกด Open

    ยังไม่ได้ลง: uv ไม่มีตัวติดตั้งแบบกดเอง คัดลอกคำสั่งหนึ่งบรรทัดของเครื่องคุณ (macOS หรือ Windows) จากหน้าทางการของ uv ไปวางใน Terminal · ไม่ต้องลง Python แยก uv ดาวน์โหลดให้เองเมื่อต้องใช้

    เปิดหน้าดาวน์โหลด uv ↗

    ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น: uv --version

    ลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ uv

  2. สมัครและสร้างคีย์ของ Homelab Infra MCP

    เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ

    วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง

  3. เปิด Terminal

    Mac: กด Command+Space พิมพ์ Terminal · Windows: เปิด PowerShell

  4. วางคำสั่งนี้แล้วกด Enter

    claude mcp add --scope user homelab-infra --env HOMELAB_PROXY_PASSWORD='ใส่ค่าของคุณ' --env HOMELAB_DOCKER_PORTAINER_TOKEN='ใส่ค่าของคุณ' --env HOMELAB_DNS_API_TOKEN='ใส่ค่าของคุณ' --env HOMELAB_HOME_ASSISTANT_TOKEN='ใส่ค่าของคุณ' --env HOMELAB_UPTIME_API_KEY='ใส่ค่าของคุณ' --env HOMELAB_TUNNEL_API_TOKEN='ใส่ค่าของคุณ' --env HOMELAB_DNS_FILTER_PASSWORD='ใส่ค่าของคุณ' --env HOMELAB_SSO_TOKEN='ใส่ค่าของคุณ' -- uvx homelab-infra-mcp

    แก้ “ใส่ค่าของคุณ” เป็นคีย์ของคุณก่อนกด Enter

    วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร

  5. พิมพ์ /mcp ใน Claude Code

    ต้องเห็น Homelab Infra MCP ในรายการและขึ้นว่าเชื่อมต่อแล้ว

  6. ลองเลย

    ใช้ Homelab Infra MCP บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า Claude Code บอกว่ากำลังใช้ Homelab Infra MCP หรือมีชื่อเครื่องมือของ Homelab Infra MCP ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ค่าตั้งเพิ่มเติม 19 ช่อง (ไม่ต้องกรอกก็ใช้ได้)

คำสั่งด้านบนใช้ได้เลยโดยไม่ต้องใส่ค่าเหล่านี้ ถ้าอยากปรับค่อยเพิ่มเองตามคำอธิบายของผู้ทำ

  • HOMELAB_PROXY_URL ที่อยู่ของ Nginx Proxy Manager เช่น http://localhost:81
    ดูต้นฉบับภาษาอังกฤษNginx Proxy Manager address, e.g. http://localhost:81
  • HOMELAB_PROXY_EMAIL อีเมลผู้ดูแลระบบของ Nginx Proxy Manager
    ดูต้นฉบับภาษาอังกฤษNginx Proxy Manager admin email
  • HOMELAB_DOCKER_HOST ที่อยู่ของ Docker engine เช่น unix:///var/run/docker.sock
    ดูต้นฉบับภาษาอังกฤษDocker engine address, e.g. unix:///var/run/docker.sock
  • HOMELAB_DOCKER_PORTAINER_URL URL พื้นฐานของ Portainer ใช้แทน Docker socket
    ดูต้นฉบับภาษาอังกฤษPortainer base URL, instead of the Docker socket
  • HOMELAB_DOCKER_PORTAINER_ENDPOINT_ID รหัส endpoint ของ Portainer (ค่าเริ่มต้น 1)
    ดูต้นฉบับภาษาอังกฤษPortainer endpoint id (default 1)
  • HOMELAB_DNS_ZONE_ID รหัส zone ของ Cloudflare เริ่มต้น
    ดูต้นฉบับภาษาอังกฤษDefault Cloudflare zone id
  • HOMELAB_HOME_ASSISTANT_URL ที่อยู่ของ Home Assistant (โมดูลนี้ปิดอยู่โดยค่าเริ่มต้น)
    ดูต้นฉบับภาษาอังกฤษHome Assistant address (module is off by default)
  • HOMELAB_UPTIME_ENABLED true เปิดใช้งานโมดูล Uptime Kuma (ปิดเป็นค่าเริ่มต้น)
    ดูต้นฉบับภาษาอังกฤษtrue turns on the Uptime Kuma module (off by default)
  • HOMELAB_UPTIME_URL ที่อยู่ของ Uptime Kuma
    ดูต้นฉบับภาษาอังกฤษUptime Kuma address
  • HOMELAB_TUNNEL_ENABLED true เปิดใช้งานโมดูล Cloudflare Tunnel (ปิดเป็นค่าเริ่มต้น)
    ดูต้นฉบับภาษาอังกฤษtrue turns on the Cloudflare Tunnel module (off by default)
  • HOMELAB_TUNNEL_ACCOUNT_ID รหัสบัญชี Cloudflare ที่เป็นเจ้าของ tunnel
    ดูต้นฉบับภาษาอังกฤษCloudflare account id that owns the tunnel
  • HOMELAB_TUNNEL_TUNNEL_ID รหัส Cloudflare Tunnel
    ดูต้นฉบับภาษาอังกฤษCloudflare Tunnel id
  • HOMELAB_DNS_FILTER_ENABLED true เปิดใช้งานโมดูล AdGuard Home (ปิดไว้เป็นค่าเริ่มต้น)
    ดูต้นฉบับภาษาอังกฤษtrue turns on the AdGuard Home module (off by default)
  • HOMELAB_DNS_FILTER_URL ที่อยู่ของ AdGuard Home
    ดูต้นฉบับภาษาอังกฤษAdGuard Home address
  • HOMELAB_DNS_FILTER_USERNAME ชื่อผู้ใช้ของ AdGuard Home
    ดูต้นฉบับภาษาอังกฤษAdGuard Home login
  • HOMELAB_SSO_ENABLED true เปิดใช้งานโมดูล Authentik (ปิดไว้เป็นค่าเริ่มต้น)
    ดูต้นฉบับภาษาอังกฤษtrue turns on the Authentik module (off by default)
  • HOMELAB_SSO_URL ที่อยู่ของ Authentik
    ดูต้นฉบับภาษาอังกฤษAuthentik address
  • HOMELAB_SSO_FLOW_SLUG slug ของโฟลว์การอนุญาตของ Authentik ที่ใช้กับผู้ให้บริการพร็อกซีใหม่
    ดูต้นฉบับภาษาอังกฤษAuthentik authorization flow slug used for new proxy providers
  • HOMELAB_READ_ONLY true จะปฏิเสธทุกการเปลี่ยนแปลง
    ดูต้นฉบับภาษาอังกฤษtrue refuses every change

คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ Cursor ได้ แต่ต้องเตรียมก่อน

ต้องมีคีย์ของ Homelab Infra MCP (สร้างที่เว็บของผู้ทำ) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)

ให้ AI ติดตั้งให้

คัดลอกข้อความนี้ไปวางในแชตของ Cursor AI จะเช็กเครื่อง บอกว่าจะแก้ไฟล์ไหน และรอคุณตกลงก่อนทุกครั้ง

ช่วยติดตั้ง MCP server ชื่อ Homelab Infra MCP ให้ Cursor ในเครื่องนี้ ทำตามลำดับ 1) เช็กว่ามี uv ด้วยคำสั่ง uv --version ถ้าไม่มี ให้บอกฉันไปลงจาก https://docs.astral.sh/uv/getting-started/installation/ ห้ามลงเอง 2) ใช้คอนฟิกนี้เท่านั้น (ผ่านตัวตรวจของ PopNx MCP แล้ว): { "mcpServers": { "homelab-infra": { "command": "uvx", "args": [ "homelab-infra-mcp" ], "env": { "HOMELAB_PROXY_PASSWORD": "ใส่ค่าของคุณ", "HOMELAB_DOCKER_PORTAINER_TOKEN": "ใส่ค่าของคุณ", "HOMELAB_DNS_API_TOKEN": "ใส่ค่าของคุณ", "HOMELAB_HOME_ASSISTANT_TOKEN": "ใส่ค่าของคุณ", "HOMELAB_UPTIME_API_KEY": "ใส่ค่าของคุณ", "HOMELAB_TUNNEL_API_TOKEN": "ใส่ค่าของคุณ", "HOMELAB_DNS_FILTER_PASSWORD": "ใส่ค่าของคุณ", "HOMELAB_SSO_TOKEN": "ใส่ค่าของคุณ" } } } } 3) บอก path เต็มของไฟล์ที่จะแก้ หรือคำสั่งที่จะรัน แล้วรอฉันตกลงก่อน 4) ช่อง HOMELAB_PROXY_PASSWORD, HOMELAB_DOCKER_PORTAINER_TOKEN, HOMELAB_DNS_API_TOKEN, HOMELAB_HOME_ASSISTANT_TOKEN, HOMELAB_UPTIME_API_KEY, HOMELAB_TUNNEL_API_TOKEN, HOMELAB_DNS_FILTER_PASSWORD, HOMELAB_SSO_TOKEN ให้คงคำว่า "ใส่ค่าของคุณ" ไว้ก่อน แล้วบอกให้ฉันวางค่าจริงเองในไฟล์หรือช่องของแอป ห้ามขอให้ฉันพิมพ์คีย์ในแชต 5) ทำตามที่ตกลง แล้วตรวจว่าเครื่องมือของ Homelab Infra MCP ขึ้นจริง

ข้อความนี้ไม่มีคีย์ของคุณ ถ้าต้องใช้คีย์ AI จะบอกให้คุณวางเองในไฟล์หรือช่องของแอป

  1. ลง uv ในเครื่อง (ถ้ายังไม่มี)

    ลงไว้แล้วหรือยัง? เช็กก่อน · เปิด Terminal แล้วพิมพ์คำสั่งนี้ กด Enter

    uv --version
    • ขึ้นเลขรุ่น เช่น uv … = ลงแล้ว ข้ามขั้นนี้ได้
    • ขึ้นว่า "command not found" (Windows ขึ้นว่า "is not recognized") = ยังไม่ได้ลง หรือเพิ่งลงแต่ยังไม่ได้ปิดแล้วเปิด Terminal ใหม่
    เปิด Terminal ยังไง

    Mac: กด ⌘ + Space พิมพ์ Terminal แล้วกด Enter

    Windows: เปิดเมนู Start พิมพ์ Windows PowerShell แล้วกด Open

    ยังไม่ได้ลง: uv ไม่มีตัวติดตั้งแบบกดเอง คัดลอกคำสั่งหนึ่งบรรทัดของเครื่องคุณ (macOS หรือ Windows) จากหน้าทางการของ uv ไปวางใน Terminal · ไม่ต้องลง Python แยก uv ดาวน์โหลดให้เองเมื่อต้องใช้

    เปิดหน้าดาวน์โหลด uv ↗

    ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น: uv --version

    ลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ uv

  2. สมัครและสร้างคีย์ของ Homelab Infra MCP

    เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ

    วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง

  3. กดปุ่มนี้เพื่อเปิด Cursor

    เปิดใน Cursor

    Cursor จะถามยืนยันการติดตั้ง ให้กด Install

  4. ใส่คีย์ในช่องที่ว่างไว้

    ในค่าตั้งของ Homelab Infra MCP ช่อง HOMELAB_PROXY_PASSWORD, HOMELAB_DOCKER_PORTAINER_TOKEN, HOMELAB_DNS_API_TOKEN, HOMELAB_HOME_ASSISTANT_TOKEN, HOMELAB_UPTIME_API_KEY, HOMELAB_TUNNEL_API_TOKEN, HOMELAB_DNS_FILTER_PASSWORD, HOMELAB_SSO_TOKEN ยังว่าง ใส่คีย์ของคุณแล้วบันทึก

    วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร

  5. เปิดแชตของ AI ใน Cursor โหมด Agent

  6. ลองเลย

    ใช้ Homelab Infra MCP บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า Cursor บอกว่ากำลังใช้ Homelab Infra MCP หรือมีชื่อเครื่องมือของ Homelab Infra MCP ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ค่าตั้งเพิ่มเติม 19 ช่อง (ไม่ต้องกรอกก็ใช้ได้)

คำสั่งด้านบนใช้ได้เลยโดยไม่ต้องใส่ค่าเหล่านี้ ถ้าอยากปรับค่อยเพิ่มเองตามคำอธิบายของผู้ทำ

  • HOMELAB_PROXY_URL ที่อยู่ของ Nginx Proxy Manager เช่น http://localhost:81
    ดูต้นฉบับภาษาอังกฤษNginx Proxy Manager address, e.g. http://localhost:81
  • HOMELAB_PROXY_EMAIL อีเมลผู้ดูแลระบบของ Nginx Proxy Manager
    ดูต้นฉบับภาษาอังกฤษNginx Proxy Manager admin email
  • HOMELAB_DOCKER_HOST ที่อยู่ของ Docker engine เช่น unix:///var/run/docker.sock
    ดูต้นฉบับภาษาอังกฤษDocker engine address, e.g. unix:///var/run/docker.sock
  • HOMELAB_DOCKER_PORTAINER_URL URL พื้นฐานของ Portainer ใช้แทน Docker socket
    ดูต้นฉบับภาษาอังกฤษPortainer base URL, instead of the Docker socket
  • HOMELAB_DOCKER_PORTAINER_ENDPOINT_ID รหัส endpoint ของ Portainer (ค่าเริ่มต้น 1)
    ดูต้นฉบับภาษาอังกฤษPortainer endpoint id (default 1)
  • HOMELAB_DNS_ZONE_ID รหัส zone ของ Cloudflare เริ่มต้น
    ดูต้นฉบับภาษาอังกฤษDefault Cloudflare zone id
  • HOMELAB_HOME_ASSISTANT_URL ที่อยู่ของ Home Assistant (โมดูลนี้ปิดอยู่โดยค่าเริ่มต้น)
    ดูต้นฉบับภาษาอังกฤษHome Assistant address (module is off by default)
  • HOMELAB_UPTIME_ENABLED true เปิดใช้งานโมดูล Uptime Kuma (ปิดเป็นค่าเริ่มต้น)
    ดูต้นฉบับภาษาอังกฤษtrue turns on the Uptime Kuma module (off by default)
  • HOMELAB_UPTIME_URL ที่อยู่ของ Uptime Kuma
    ดูต้นฉบับภาษาอังกฤษUptime Kuma address
  • HOMELAB_TUNNEL_ENABLED true เปิดใช้งานโมดูล Cloudflare Tunnel (ปิดเป็นค่าเริ่มต้น)
    ดูต้นฉบับภาษาอังกฤษtrue turns on the Cloudflare Tunnel module (off by default)
  • HOMELAB_TUNNEL_ACCOUNT_ID รหัสบัญชี Cloudflare ที่เป็นเจ้าของ tunnel
    ดูต้นฉบับภาษาอังกฤษCloudflare account id that owns the tunnel
  • HOMELAB_TUNNEL_TUNNEL_ID รหัส Cloudflare Tunnel
    ดูต้นฉบับภาษาอังกฤษCloudflare Tunnel id
  • HOMELAB_DNS_FILTER_ENABLED true เปิดใช้งานโมดูล AdGuard Home (ปิดไว้เป็นค่าเริ่มต้น)
    ดูต้นฉบับภาษาอังกฤษtrue turns on the AdGuard Home module (off by default)
  • HOMELAB_DNS_FILTER_URL ที่อยู่ของ AdGuard Home
    ดูต้นฉบับภาษาอังกฤษAdGuard Home address
  • HOMELAB_DNS_FILTER_USERNAME ชื่อผู้ใช้ของ AdGuard Home
    ดูต้นฉบับภาษาอังกฤษAdGuard Home login
  • HOMELAB_SSO_ENABLED true เปิดใช้งานโมดูล Authentik (ปิดไว้เป็นค่าเริ่มต้น)
    ดูต้นฉบับภาษาอังกฤษtrue turns on the Authentik module (off by default)
  • HOMELAB_SSO_URL ที่อยู่ของ Authentik
    ดูต้นฉบับภาษาอังกฤษAuthentik address
  • HOMELAB_SSO_FLOW_SLUG slug ของโฟลว์การอนุญาตของ Authentik ที่ใช้กับผู้ให้บริการพร็อกซีใหม่
    ดูต้นฉบับภาษาอังกฤษAuthentik authorization flow slug used for new proxy providers
  • HOMELAB_READ_ONLY true จะปฏิเสธทุกการเปลี่ยนแปลง
    ดูต้นฉบับภาษาอังกฤษtrue refuses every change

คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Cursor เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ VS Code ได้ แต่ต้องเตรียมก่อน

ต้องมีคีย์ของ Homelab Infra MCP (สร้างที่เว็บของผู้ทำ) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)

ให้ AI ติดตั้งให้

คัดลอกข้อความนี้ไปวางในแชตของ VS Code AI จะเช็กเครื่อง บอกว่าจะแก้ไฟล์ไหน และรอคุณตกลงก่อนทุกครั้ง

ช่วยติดตั้ง MCP server ชื่อ Homelab Infra MCP ให้ VS Code ในเครื่องนี้ ทำตามลำดับ 1) เช็กว่ามี uv ด้วยคำสั่ง uv --version ถ้าไม่มี ให้บอกฉันไปลงจาก https://docs.astral.sh/uv/getting-started/installation/ ห้ามลงเอง 2) ใช้คอนฟิกนี้เท่านั้น (ผ่านตัวตรวจของ PopNx MCP แล้ว): { "servers": { "homelab-infra": { "type": "stdio", "command": "uvx", "args": [ "homelab-infra-mcp" ], "env": { "HOMELAB_PROXY_PASSWORD": "ใส่ค่าของคุณ", "HOMELAB_DOCKER_PORTAINER_TOKEN": "ใส่ค่าของคุณ", "HOMELAB_DNS_API_TOKEN": "ใส่ค่าของคุณ", "HOMELAB_HOME_ASSISTANT_TOKEN": "ใส่ค่าของคุณ", "HOMELAB_UPTIME_API_KEY": "ใส่ค่าของคุณ", "HOMELAB_TUNNEL_API_TOKEN": "ใส่ค่าของคุณ", "HOMELAB_DNS_FILTER_PASSWORD": "ใส่ค่าของคุณ", "HOMELAB_SSO_TOKEN": "ใส่ค่าของคุณ" } } } } 3) บอก path เต็มของไฟล์ที่จะแก้ หรือคำสั่งที่จะรัน แล้วรอฉันตกลงก่อน 4) ช่อง HOMELAB_PROXY_PASSWORD, HOMELAB_DOCKER_PORTAINER_TOKEN, HOMELAB_DNS_API_TOKEN, HOMELAB_HOME_ASSISTANT_TOKEN, HOMELAB_UPTIME_API_KEY, HOMELAB_TUNNEL_API_TOKEN, HOMELAB_DNS_FILTER_PASSWORD, HOMELAB_SSO_TOKEN ให้คงคำว่า "ใส่ค่าของคุณ" ไว้ก่อน แล้วบอกให้ฉันวางค่าจริงเองในไฟล์หรือช่องของแอป ห้ามขอให้ฉันพิมพ์คีย์ในแชต 5) ทำตามที่ตกลง แล้วตรวจว่าเครื่องมือของ Homelab Infra MCP ขึ้นจริง

ข้อความนี้ไม่มีคีย์ของคุณ ถ้าต้องใช้คีย์ AI จะบอกให้คุณวางเองในไฟล์หรือช่องของแอป

  1. ลง uv ในเครื่อง (ถ้ายังไม่มี)

    ลงไว้แล้วหรือยัง? เช็กก่อน · เปิด Terminal แล้วพิมพ์คำสั่งนี้ กด Enter

    uv --version
    • ขึ้นเลขรุ่น เช่น uv … = ลงแล้ว ข้ามขั้นนี้ได้
    • ขึ้นว่า "command not found" (Windows ขึ้นว่า "is not recognized") = ยังไม่ได้ลง หรือเพิ่งลงแต่ยังไม่ได้ปิดแล้วเปิด Terminal ใหม่
    เปิด Terminal ยังไง

    Mac: กด ⌘ + Space พิมพ์ Terminal แล้วกด Enter

    Windows: เปิดเมนู Start พิมพ์ Windows PowerShell แล้วกด Open

    ยังไม่ได้ลง: uv ไม่มีตัวติดตั้งแบบกดเอง คัดลอกคำสั่งหนึ่งบรรทัดของเครื่องคุณ (macOS หรือ Windows) จากหน้าทางการของ uv ไปวางใน Terminal · ไม่ต้องลง Python แยก uv ดาวน์โหลดให้เองเมื่อต้องใช้

    เปิดหน้าดาวน์โหลด uv ↗

    ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น: uv --version

    ลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ uv

  2. สมัครและสร้างคีย์ของ Homelab Infra MCP

    เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ

    วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง

  3. กดปุ่มนี้เพื่อเปิด VS Code

    เปิดใน VS Code

    VS Code จะถามยืนยันการติดตั้ง ให้กด Install

  4. ใส่คีย์ในช่องที่ว่างไว้

    ในค่าตั้งของ Homelab Infra MCP ช่อง HOMELAB_PROXY_PASSWORD, HOMELAB_DOCKER_PORTAINER_TOKEN, HOMELAB_DNS_API_TOKEN, HOMELAB_HOME_ASSISTANT_TOKEN, HOMELAB_UPTIME_API_KEY, HOMELAB_TUNNEL_API_TOKEN, HOMELAB_DNS_FILTER_PASSWORD, HOMELAB_SSO_TOKEN ยังว่าง ใส่คีย์ของคุณแล้วบันทึก

    วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร

  5. เปิดแชตของ AI ใน VS Code โหมด Agent

  6. ลองเลย

    ใช้ Homelab Infra MCP บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า VS Code บอกว่ากำลังใช้ Homelab Infra MCP หรือมีชื่อเครื่องมือของ Homelab Infra MCP ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ค่าตั้งเพิ่มเติม 19 ช่อง (ไม่ต้องกรอกก็ใช้ได้)

คำสั่งด้านบนใช้ได้เลยโดยไม่ต้องใส่ค่าเหล่านี้ ถ้าอยากปรับค่อยเพิ่มเองตามคำอธิบายของผู้ทำ

  • HOMELAB_PROXY_URL ที่อยู่ของ Nginx Proxy Manager เช่น http://localhost:81
    ดูต้นฉบับภาษาอังกฤษNginx Proxy Manager address, e.g. http://localhost:81
  • HOMELAB_PROXY_EMAIL อีเมลผู้ดูแลระบบของ Nginx Proxy Manager
    ดูต้นฉบับภาษาอังกฤษNginx Proxy Manager admin email
  • HOMELAB_DOCKER_HOST ที่อยู่ของ Docker engine เช่น unix:///var/run/docker.sock
    ดูต้นฉบับภาษาอังกฤษDocker engine address, e.g. unix:///var/run/docker.sock
  • HOMELAB_DOCKER_PORTAINER_URL URL พื้นฐานของ Portainer ใช้แทน Docker socket
    ดูต้นฉบับภาษาอังกฤษPortainer base URL, instead of the Docker socket
  • HOMELAB_DOCKER_PORTAINER_ENDPOINT_ID รหัส endpoint ของ Portainer (ค่าเริ่มต้น 1)
    ดูต้นฉบับภาษาอังกฤษPortainer endpoint id (default 1)
  • HOMELAB_DNS_ZONE_ID รหัส zone ของ Cloudflare เริ่มต้น
    ดูต้นฉบับภาษาอังกฤษDefault Cloudflare zone id
  • HOMELAB_HOME_ASSISTANT_URL ที่อยู่ของ Home Assistant (โมดูลนี้ปิดอยู่โดยค่าเริ่มต้น)
    ดูต้นฉบับภาษาอังกฤษHome Assistant address (module is off by default)
  • HOMELAB_UPTIME_ENABLED true เปิดใช้งานโมดูล Uptime Kuma (ปิดเป็นค่าเริ่มต้น)
    ดูต้นฉบับภาษาอังกฤษtrue turns on the Uptime Kuma module (off by default)
  • HOMELAB_UPTIME_URL ที่อยู่ของ Uptime Kuma
    ดูต้นฉบับภาษาอังกฤษUptime Kuma address
  • HOMELAB_TUNNEL_ENABLED true เปิดใช้งานโมดูล Cloudflare Tunnel (ปิดเป็นค่าเริ่มต้น)
    ดูต้นฉบับภาษาอังกฤษtrue turns on the Cloudflare Tunnel module (off by default)
  • HOMELAB_TUNNEL_ACCOUNT_ID รหัสบัญชี Cloudflare ที่เป็นเจ้าของ tunnel
    ดูต้นฉบับภาษาอังกฤษCloudflare account id that owns the tunnel
  • HOMELAB_TUNNEL_TUNNEL_ID รหัส Cloudflare Tunnel
    ดูต้นฉบับภาษาอังกฤษCloudflare Tunnel id
  • HOMELAB_DNS_FILTER_ENABLED true เปิดใช้งานโมดูล AdGuard Home (ปิดไว้เป็นค่าเริ่มต้น)
    ดูต้นฉบับภาษาอังกฤษtrue turns on the AdGuard Home module (off by default)
  • HOMELAB_DNS_FILTER_URL ที่อยู่ของ AdGuard Home
    ดูต้นฉบับภาษาอังกฤษAdGuard Home address
  • HOMELAB_DNS_FILTER_USERNAME ชื่อผู้ใช้ของ AdGuard Home
    ดูต้นฉบับภาษาอังกฤษAdGuard Home login
  • HOMELAB_SSO_ENABLED true เปิดใช้งานโมดูล Authentik (ปิดไว้เป็นค่าเริ่มต้น)
    ดูต้นฉบับภาษาอังกฤษtrue turns on the Authentik module (off by default)
  • HOMELAB_SSO_URL ที่อยู่ของ Authentik
    ดูต้นฉบับภาษาอังกฤษAuthentik address
  • HOMELAB_SSO_FLOW_SLUG slug ของโฟลว์การอนุญาตของ Authentik ที่ใช้กับผู้ให้บริการพร็อกซีใหม่
    ดูต้นฉบับภาษาอังกฤษAuthentik authorization flow slug used for new proxy providers
  • HOMELAB_READ_ONLY true จะปฏิเสธทุกการเปลี่ยนแปลง
    ดูต้นฉบับภาษาอังกฤษtrue refuses every change

คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ VS Code เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

โปรแกรมอื่นที่ใช้ MCP ได้ เช่น Windsurf, Zed หรือ Gemini CLI มีวิธีเพิ่มต่างกัน ดูวิธีของแต่ละตัวในหน้ารวมโปรแกรม

ดูโปรแกรมที่ใช้ MCP ทั้งหมด →

ค่าตั้งแบบไฟล์ JSON อยู่ในหัวข้อ “สำหรับคนเขียนโค้ด” ด้านล่าง

ติดตรงไหน? ถามคนที่ใช้ Homelab Infra MCP อยู่💬 พูดคุย →
สำหรับคนเขียนโค้ด: คำสั่ง Terminal และค่าตั้ง JSON

ติดตั้งในเครื่อง

Claude Code

claude mcp add --scope user homelab-infra --env HOMELAB_PROXY_PASSWORD='ใส่ค่าของคุณ' --env HOMELAB_DOCKER_PORTAINER_TOKEN='ใส่ค่าของคุณ' --env HOMELAB_DNS_API_TOKEN='ใส่ค่าของคุณ' --env HOMELAB_HOME_ASSISTANT_TOKEN='ใส่ค่าของคุณ' --env HOMELAB_UPTIME_API_KEY='ใส่ค่าของคุณ' --env HOMELAB_TUNNEL_API_TOKEN='ใส่ค่าของคุณ' --env HOMELAB_DNS_FILTER_PASSWORD='ใส่ค่าของคุณ' --env HOMELAB_SSO_TOKEN='ใส่ค่าของคุณ' -- uvx homelab-infra-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "homelab-infra": {
      "command": "uvx",
      "args": [
        "homelab-infra-mcp"
      ],
      "env": {
        "HOMELAB_PROXY_PASSWORD": "ใส่ค่าของคุณ",
        "HOMELAB_DOCKER_PORTAINER_TOKEN": "ใส่ค่าของคุณ",
        "HOMELAB_DNS_API_TOKEN": "ใส่ค่าของคุณ",
        "HOMELAB_HOME_ASSISTANT_TOKEN": "ใส่ค่าของคุณ",
        "HOMELAB_UPTIME_API_KEY": "ใส่ค่าของคุณ",
        "HOMELAB_TUNNEL_API_TOKEN": "ใส่ค่าของคุณ",
        "HOMELAB_DNS_FILTER_PASSWORD": "ใส่ค่าของคุณ",
        "HOMELAB_SSO_TOKEN": "ใส่ค่าของคุณ"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "homelab-infra": {
      "command": "uvx",
      "args": [
        "homelab-infra-mcp"
      ],
      "env": {
        "HOMELAB_PROXY_PASSWORD": "ใส่ค่าของคุณ",
        "HOMELAB_DOCKER_PORTAINER_TOKEN": "ใส่ค่าของคุณ",
        "HOMELAB_DNS_API_TOKEN": "ใส่ค่าของคุณ",
        "HOMELAB_HOME_ASSISTANT_TOKEN": "ใส่ค่าของคุณ",
        "HOMELAB_UPTIME_API_KEY": "ใส่ค่าของคุณ",
        "HOMELAB_TUNNEL_API_TOKEN": "ใส่ค่าของคุณ",
        "HOMELAB_DNS_FILTER_PASSWORD": "ใส่ค่าของคุณ",
        "HOMELAB_SSO_TOKEN": "ใส่ค่าของคุณ"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "homelab-infra": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "homelab-infra-mcp"
      ],
      "env": {
        "HOMELAB_PROXY_PASSWORD": "ใส่ค่าของคุณ",
        "HOMELAB_DOCKER_PORTAINER_TOKEN": "ใส่ค่าของคุณ",
        "HOMELAB_DNS_API_TOKEN": "ใส่ค่าของคุณ",
        "HOMELAB_HOME_ASSISTANT_TOKEN": "ใส่ค่าของคุณ",
        "HOMELAB_UPTIME_API_KEY": "ใส่ค่าของคุณ",
        "HOMELAB_TUNNEL_API_TOKEN": "ใส่ค่าของคุณ",
        "HOMELAB_DNS_FILTER_PASSWORD": "ใส่ค่าของคุณ",
        "HOMELAB_SSO_TOKEN": "ใส่ค่าของคุณ"
      }
    }
  }
}

ค่าที่ต้องใส่เอง

  • HOMELAB_PROXY_URL env
    ที่อยู่ของ Nginx Proxy Manager เช่น http://localhost:81
    ดูต้นฉบับภาษาอังกฤษNginx Proxy Manager address, e.g. http://localhost:81
  • HOMELAB_PROXY_EMAIL env
    อีเมลผู้ดูแลระบบของ Nginx Proxy Manager
    ดูต้นฉบับภาษาอังกฤษNginx Proxy Manager admin email
  • HOMELAB_PROXY_PASSWORD ความลับ จำเป็น env
    รหัสผ่านผู้ดูแลระบบของ Nginx Proxy Manager
    ดูต้นฉบับภาษาอังกฤษNginx Proxy Manager admin password
  • HOMELAB_DOCKER_HOST env
    ที่อยู่ของ Docker engine เช่น unix:///var/run/docker.sock
    ดูต้นฉบับภาษาอังกฤษDocker engine address, e.g. unix:///var/run/docker.sock
  • HOMELAB_DOCKER_PORTAINER_URL env
    URL พื้นฐานของ Portainer ใช้แทน Docker socket
    ดูต้นฉบับภาษาอังกฤษPortainer base URL, instead of the Docker socket
  • HOMELAB_DOCKER_PORTAINER_TOKEN ความลับ จำเป็น env
    API key ของ Portainer
    ดูต้นฉบับภาษาอังกฤษPortainer API key
  • HOMELAB_DOCKER_PORTAINER_ENDPOINT_ID env
    รหัส endpoint ของ Portainer (ค่าเริ่มต้น 1)
    ดูต้นฉบับภาษาอังกฤษPortainer endpoint id (default 1)
  • HOMELAB_DNS_API_TOKEN ความลับ จำเป็น env
    โทเคน API ของ Cloudflare ที่มีสิทธิ์แก้ไข DNS
    ดูต้นฉบับภาษาอังกฤษCloudflare API token with DNS edit permission
  • HOMELAB_DNS_ZONE_ID env
    รหัส zone ของ Cloudflare เริ่มต้น
    ดูต้นฉบับภาษาอังกฤษDefault Cloudflare zone id
  • HOMELAB_HOME_ASSISTANT_URL env
    ที่อยู่ของ Home Assistant (โมดูลนี้ปิดอยู่โดยค่าเริ่มต้น)
    ดูต้นฉบับภาษาอังกฤษHome Assistant address (module is off by default)
  • HOMELAB_HOME_ASSISTANT_TOKEN ความลับ จำเป็น env
    โทเค็นการเข้าถึงระยะยาวของ Home Assistant
    ดูต้นฉบับภาษาอังกฤษHome Assistant long-lived access token
  • HOMELAB_UPTIME_ENABLED env
    true เปิดใช้งานโมดูล Uptime Kuma (ปิดเป็นค่าเริ่มต้น)
    ดูต้นฉบับภาษาอังกฤษtrue turns on the Uptime Kuma module (off by default)
  • HOMELAB_UPTIME_URL env
    ที่อยู่ของ Uptime Kuma
    ดูต้นฉบับภาษาอังกฤษUptime Kuma address
  • HOMELAB_UPTIME_API_KEY ความลับ จำเป็น env
    คีย์ API ของ Uptime Kuma อ่านจาก /metrics
    ดูต้นฉบับภาษาอังกฤษUptime Kuma API key, read from /metrics
  • HOMELAB_TUNNEL_ENABLED env
    true เปิดใช้งานโมดูล Cloudflare Tunnel (ปิดเป็นค่าเริ่มต้น)
    ดูต้นฉบับภาษาอังกฤษtrue turns on the Cloudflare Tunnel module (off by default)
  • HOMELAB_TUNNEL_API_TOKEN ความลับ จำเป็น env
    โทเคน API ของ Cloudflare ที่มีสิทธิ์แก้ไข tunnel
    ดูต้นฉบับภาษาอังกฤษCloudflare API token with tunnel edit permission
  • HOMELAB_TUNNEL_ACCOUNT_ID env
    รหัสบัญชี Cloudflare ที่เป็นเจ้าของ tunnel
    ดูต้นฉบับภาษาอังกฤษCloudflare account id that owns the tunnel
  • HOMELAB_TUNNEL_TUNNEL_ID env
    รหัส Cloudflare Tunnel
    ดูต้นฉบับภาษาอังกฤษCloudflare Tunnel id
  • HOMELAB_DNS_FILTER_ENABLED env
    true เปิดใช้งานโมดูล AdGuard Home (ปิดไว้เป็นค่าเริ่มต้น)
    ดูต้นฉบับภาษาอังกฤษtrue turns on the AdGuard Home module (off by default)
  • HOMELAB_DNS_FILTER_URL env
    ที่อยู่ของ AdGuard Home
    ดูต้นฉบับภาษาอังกฤษAdGuard Home address
  • HOMELAB_DNS_FILTER_USERNAME env
    ชื่อผู้ใช้ของ AdGuard Home
    ดูต้นฉบับภาษาอังกฤษAdGuard Home login
  • HOMELAB_DNS_FILTER_PASSWORD ความลับ จำเป็น env
    รหัสผ่านของ AdGuard Home
    ดูต้นฉบับภาษาอังกฤษAdGuard Home password
  • HOMELAB_SSO_ENABLED env
    true เปิดใช้งานโมดูล Authentik (ปิดไว้เป็นค่าเริ่มต้น)
    ดูต้นฉบับภาษาอังกฤษtrue turns on the Authentik module (off by default)
  • HOMELAB_SSO_URL env
    ที่อยู่ของ Authentik
    ดูต้นฉบับภาษาอังกฤษAuthentik address
  • HOMELAB_SSO_TOKEN ความลับ จำเป็น env
    โทเค็น API ของ Authentik
    ดูต้นฉบับภาษาอังกฤษAuthentik API token
  • HOMELAB_SSO_FLOW_SLUG env
    slug ของโฟลว์การอนุญาตของ Authentik ที่ใช้กับผู้ให้บริการพร็อกซีใหม่
    ดูต้นฉบับภาษาอังกฤษAuthentik authorization flow slug used for new proxy providers
  • HOMELAB_READ_ONLY env
    true จะปฏิเสธทุกการเปลี่ยนแปลง
    ดูต้นฉบับภาษาอังกฤษtrue refuses every change

คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ

ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README

สรุป

ดาวน์โหลดต่อสัปดาห์i
54/สัปดาห์
การเชื่อมต่อ
รันบนเครื่อง
รุ่นล่าสุดi
2.1.1
ส่งเข้า registryi
28 ต.ค. 2569
แก้โค้ดล่าสุดi
3 พ.ย. 2569
ผู้ทำ
seayniclabs
แพ็กเกจ
pypi: homelab-infra-mcp
สถานะใน registry
ใช้งานอยู่

ใช้กับโปรแกรมไหนได้

ดูจากแบบการต่อของ server ตัวนี้ และเอกสารของผู้ทำโปรแกรมแต่ละตัว ตรวจเมื่อ 10 พ.ย. 2569

ติดตั้งบนเครื่องได้ใน

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

ดูโปรแกรมทั้งหมดพร้อมข้อดีข้อเสีย →

คู่มือที่เกี่ยวข้อง

ทำอะไรได้บ้าง

รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง

ผลตรวจเบื้องต้นi

เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 20 พ.ย. 2569

  • ✓ ผ่าน

    ตัวตนผู้ทำตรงกับ repo

    ชื่อใน registry ยืนยันด้วยบัญชี GitHub seayniclabs ซึ่งเป็นเจ้าของ repo

  • ✓ ผ่าน

    ยังมีคนดูแล

    มีการแก้โค้ดล่าสุด 17 วันที่ผ่านมา

  • ✓ ผ่าน

    มีสัญญาอนุญาต (license)

    ใช้ MIT

  • – ไม่เกี่ยว

    endpoint ตอบ

    ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต

  • – ไม่เกี่ยว

    ล็อกอินแบบ OAuth

    ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน

  • … ยังไม่ตรวจ

    คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง

    รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต

ช่องโหว่ที่เปิดเผยแล้ว (OSV.dev)

ไม่พบรายการใน OSV.dev สำหรับ homelab-infra-mcp@2.1.1

ตรวจเฉพาะตัวแพ็กเกจรุ่นนี้ ไม่ใช่ทุก dependency · ตรวจเมื่อ 16 พ.ย. 2569

เราตรวจอะไรบ้าง → · JSON

ผู้ทำ: ขอให้ตรวจใหม่ หรือแจ้งข้อมูลผิด
สำหรับผู้ทำ: ติดป้ายใน README

ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้

[![แนะนำบน PopNx MCP](https://mcp.popnx.com/badge/seayniclabs-homelab-infra-mcp.svg?lang=th)](https://mcp.popnx.com/th/servers/seayniclabs-homelab-infra-mcp)

พูดคุย

ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์

ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย

ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx

เข้าสู่ระบบเพื่อโพสต์

รีวิวจากผู้ใช้

ยังไม่มีรีวิว

เข้าสู่ระบบเพื่อเขียนรีวิว

เทียบกับตัวอื่นในหมวด เครื่องมือนักพัฒนาi

  • ดาวมากกว่า 0% ของอีก 6209 ตัวในหมวดนี้
  • ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 56% ของอีก 6209 ตัวในหมวดนี้
  • ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 99% ของอีก 6209 ตัวในหมวดนี้

เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo

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

Homelab Infra MCP ปลอดภัยไหม?

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

ต้องใช้กุญแจหรือรหัสอะไรบ้าง?

ต้องใส่ค่าเหล่านี้: HOMELAB_PROXY_PASSWORD, HOMELAB_DOCKER_PORTAINER_TOKEN, HOMELAB_DNS_API_TOKEN, HOMELAB_HOME_ASSISTANT_TOKEN, HOMELAB_UPTIME_API_KEY, HOMELAB_TUNNEL_API_TOKEN, HOMELAB_DNS_FILTER_PASSWORD, HOMELAB_SSO_TOKEN

ตัวนี้รันบนเครื่องหรือบนคลาวด์?

รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)

ยังมีคนดูแลอยู่ไหม?

repo บน GitHub มีการแก้โค้ดล่าสุด 17 วันที่ผ่านมา และส่งรุ่นล่าสุด (2.1.1) เข้า registry 23 วันที่ผ่านมา

ใช้กับโปรแกรมไหนได้บ้าง?

โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Python (uv) ในเครื่องด้วย

มีตัวไหนใช้แทนได้บ้าง?

ในหมวดเดียวกันมี GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise

ตัวอื่นที่ทำงานคล้ายกัน

หมวดเดียวกันจากผู้ทำคนอื่น ผ่านตัวตรวจคำสั่งแล้ว ตัวทางการขึ้นก่อน แล้วเรียงตามดาว

อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi

GitDiagram

Architecture diagrams, explanations and Mermaid source for public GitHub repositories.

โดย ahmedkhaleel2004ใช้กันมาก★ 19Kอัปเดต 2 เดือนที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · gitdiagram.comทีม PopNx ลองใช้จริงแล้ว

Appllama

Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.

โดย Appllamaใช้กันมาก★ 5.2Kอัปเดต 3 เดือนที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · appllama.io

Cloudflare MCP

Cloudflare MCP servers

โดย cloudflareใช้กันมาก★ 4.5Kอัปเดต 14 เดือนที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · mcp.cloudflare.comทีม PopNx ลองใช้จริงแล้ว

Omnara

Deploy durable AI agents with Omnara, an open-source managed-agent platform.

โดย omnara-aiใช้กันมาก★ 3.4Kอัปเดต 2 เดือนที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · omnara.com

Repowise

Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.

โดย repowise-devใช้กันมาก↓ 6.5K/สัปดาห์★ 8.2K ดาวรวมทั้งรีโปอัปเดต 7 วันที่ผ่านมา

บนเครื่องหรือคลาวด์✓ เจ้าของบริการ · repowise.dev
เทียบกับตัวที่คล้ายกัน
ตัวนี้
Homelab Infra MCP
GitDiagramAppllamaCloudflare MCPOmnaraRepowise
ทำงานที่ไหนต้องลงในเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องมีทั้งบนคลาวด์และแบบลงเครื่อง
ต้องใส่คีย์ใช่ไม่ไม่ไม่ไม่ไม่
กด + ใน Claude ได้ไม่ไม่ไม่ใช่ไม่ไม่
ผลตรวจเบื้องต้น3/34/44/44/44/45/5
สัญญาอนุญาตMITMITMITApache-2.0Apache-2.0AGPL-3.0
ราคาไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียน

README จากผู้ทำ

เปิดอ่าน README

ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ

Homelab

Made by [Seaynic Labs](https://seayniclabs.com). Need tools like this built around your own systems? We do that.

Homelab is an MCP server that lets an AI assistant manage Nginx Proxy Manager proxy hosts, Docker containers and Cloudflare DNS records from one place. It covers the path from a container to a public web address. One call, expose_service, checks the container, adds the DNS record and the proxy host, and shows the plan before anything changes. Four more optional modules cover Uptime Kuma, Cloudflare Tunnel, AdGuard Home and Authentik.

It is a bundle: one server made of modules, plus skills that teach the assistant the workflows. You switch on the modules you use. New modules arrive switched off, so an update never changes what your assistant can do until you choose to.

Audience: self-hosters running a homelab.

ModuleWhat it doesStatus
proxyNginx Proxy Manager: proxy hosts, redirections, SSL certificates, access listsOn by default
dockerContainers, images and volumes through the local Docker socket or PortainerOn by default
dnsCloudflare DNS zones and records, and BIND exportOn by default
home_assistantEntities, automations, scripts and system info in Home AssistantOff by default, turn on with HOMELAB_HOME_ASSISTANT_ENABLED=true
uptimeUptime Kuma monitors: list and read status (read only)Off by default, turn on with HOMELAB_UPTIME_ENABLED=true
tunnelCloudflare Tunnel routes: list, add and removeOff by default, turn on with HOMELAB_TUNNEL_ENABLED=true
dns_filterAdGuard Home: filter status, query log and filter rulesOff by default, turn on with HOMELAB_DNS_FILTER_ENABLED=true
ssoAuthentik: list applications, create a proxy provider and application for one hostOff by default, turn on with HOMELAB_SSO_ENABLED=true

The core tools are always on: homelab_modules, homelab_health, expose_service, teardown_service, service_status, infrastructure_overview and diagnose_service.

Homelab works with any MCP client: Claude Desktop, Claude Code, Cursor, VS Code, Sonique, Hermes, OpenClaw and others. It runs on your own machine and keeps no data of its own. It talks only to the services you configure.

Install

Homelab needs Python 3.11 or newer. With uv there is nothing to install ahead of time. Pin the version so updates arrive only when you choose them:

uvx homelab-infra-mcp==2.1.1 --version

Or with pip:

pip install homelab-infra-mcp==2.1.1

Upgrading from 2.0? Version 2.1 has no breaking changes. The four new modules are off by default. Read the 2.1.0 section of CHANGELOG.md.

Upgrading from 1.x? Version 2.0 changed the tool names and the environment variable names. Read the migration table in CHANGELOG.md first.

Quick install

Add the server to your MCP client (see Add it to your MCP client), set the variables for the modules you use, and restart the client. Then ask the assistant to call homelab_modules. The response lists each module, whether it is on, and which settings are missing.

Doctor

Run homelab-infra --doctor in a terminal before you start, and after any settings change:

homelab-infra --doctor

The doctor checks each enabled module's settings and reachability, the Docker socket access, and the TLS check. It prints a FIX line for each problem and exits with status 1 when something needs fixing.

Settings

Set these as environment variables in your MCP client's config, or put them in a config file (see below). You only need the settings for the modules you use. Homelab starts without any of them and tells you what is missing when you call a tool.

VariableModuleWhat it is
HOMELAB_PROXY_URLproxyNginx Proxy Manager address. Default http://localhost:81.
HOMELAB_PROXY_EMAIL / HOMELAB_PROXY_PASSWORDproxyThe NPM admin login used for the API
HOMELAB_DOCKER_HOSTdockerDocker engine address. Default unix:///var/run/docker.sock.
HOMELAB_DOCKER_PORTAINER_URL / HOMELAB_DOCKER_PORTAINER_TOKENdockerUse Portainer instead of the socket. Both are needed.
HOMELAB_DOCKER_PORTAINER_ENDPOINT_IDdockerPortainer endpoint id. Default 1.
HOMELAB_DNS_API_TOKENdnsCloudflare API token with DNS edit permission on the zone
HOMELAB_DNS_ZONE_IDdnsDefault zone id, so tools can leave zone_id empty
HOMELAB_HOME_ASSISTANT_URLhome_assistantHome Assistant address. Default http://homeassistant.local:8123.
HOMELAB_HOME_ASSISTANT_TOKENhome_assistantLong-lived access token
HOMELAB_UPTIME_URLuptimeUptime Kuma address
HOMELAB_UPTIME_API_KEYuptimeUptime Kuma API key. Read from /metrics, used for list and get.
HOMELAB_TUNNEL_API_TOKENtunnelCloudflare API token with tunnel edit permission
HOMELAB_TUNNEL_ACCOUNT_IDtunnelCloudflare account id that owns the tunnel
HOMELAB_TUNNEL_TUNNEL_IDtunnelCloudflare Tunnel id
HOMELAB_DNS_FILTER_URLdns_filterAdGuard Home address
HOMELAB_DNS_FILTER_USERNAME / HOMELAB_DNS_FILTER_PASSWORDdns_filterAdGuard Home login
HOMELAB_SSO_URLssoAuthentik address
HOMELAB_SSO_TOKENssoAuthentik API token
HOMELAB_SSO_FLOW_SLUGssoAuthorization flow slug that new proxy providers use
HOMELAB_ _ENABLEDanytrue or false. Turns a module on or off, e.g. HOMELAB_UPTIME_ENABLED=true.
HOMELAB_ _ALLOW_WRITESanyfalse by default: each change asks you first. true lets the assistant make changes in that module without asking. See Safety.
HOMELAB_READ_ONLYalltrue refuses every change, whatever else is set. Reads and dry runs still work.
HOMELAB_ _ _FILEanyRead a secret from a file instead, e.g. HOMELAB_DNS_API_TOKEN_FILE=/run/secrets/cf_token
HOMELAB_CONFIGcorePath to the config file. Default ~/.config/homelab/config.toml.
HOMELAB_APPROVAL_LOGcorePath to the approval log. Default ~/.local/state/homelab/approvals.jsonl, or $XDG_STATE_HOME/homelab/approvals.jsonl when XDG_STATE_HOME is set.

Config file (optional). Homelab also reads ~/.config/homelab/config.toml, or the file named by HOMELAB_CONFIG. Each module has its own table. Environment variables win over the file.

[proxy]

email = "admin@example.com" password = "change-me"

[dns] api_token = "your-cloudflare-token" zone_id = "your-zone-id"

Turn a module on in the same file with its enabled key, or with HOMELAB_ _ENABLED=true in the environment.

Add it to your MCP client

Most clients use the same JSON shape. Pin the version so the server runs the release you tested. Put the block where your client keeps MCP servers:

{

"mcpServers": { "homelab": { "command": "uvx", "args": ["homelab-infra-mcp==2.1.1"], "env": { "HOMELAB_PROXY_EMAIL": "admin@example.com", "HOMELAB_PROXY_PASSWORD": "change-me", "HOMELAB_DNS_API_TOKEN": "your-cloudflare-token", "HOMELAB_DNS_ZONE_ID": "your-zone-id" } } } }

ClientWhere the config goes
Claude Desktopclaude_desktop_config.json (Settings → Developer → Edit Config)
Claude Codeclaude mcp add homelab -- uvx homelab-infra-mcp==2.1.1, then add the env values, or a project .mcp.json
Cursor~/.cursor/mcp.json, or .cursor/mcp.json in a project
VS Code.vscode/mcp.json, using "servers" instead of "mcpServers"
Sonique, Hermes, OpenClaw, othersAny client that launches a stdio MCP server: command uvx, args ["homelab-infra-mcp==2.1.1"], plus the env values

As a Claude Code plugin. The plugin installs the server and the skills together. Its .mcp.json pins homelab-infra-mcp==2.1.1. Set the variables in your environment or in the config file.

Over HTTP. For clients that connect to a URL instead of launching a process:

homelab-infra --transport http --port 8200

It serves streamable HTTP at http://127.0.0.1:8200/mcp. It listens only on your own machine by default. Put authentication in front of it before exposing it anywhere else.

Tools

The default install has 16 tools. Each module adds its own tools when you turn it on.

ToolWhat it does
homelab_modulesWhich modules are on, which settings are missing, and what each tool does. Call this first.
homelab_healthConnectivity and version for every enabled module
expose_serviceCheck a container, add a DNS record (optional), add a proxy host. One approved plan.
teardown_serviceRemove a service's proxy host and optional DNS record. One approved plan.
service_statusOne view of a service: container, proxy hosts, DNS records
infrastructure_overviewCounts across Docker, the proxy and DNS
diagnose_serviceRead only. Checks each hop from a domain to its service, one row per hop. Returns the first failing hop and its fix.
proxy_hostslist, get, create, update, delete proxy hosts
proxy_redirectionslist, create, delete HTTP redirections
proxy_certificateslist, request a Let's Encrypt certificate
proxy_access_listslist, create, delete IP access lists
docker_containerslist, get, start, stop, restart, remove, logs, stats, prune
docker_imageslist, pull, remove, prune
docker_inventoryvolumes, networks, or Portainer stacks (with a stack's compose file)
dns_zoneslist zones, or export one in BIND format
dns_recordslist, get, create, update, delete records
ha_entitieslist, get, search; call_service, turn_on, turn_off, toggle (Home Assistant)
ha_automationslist, trigger, reload automations or scripts; create previews automation YAML (Home Assistant)
ha_systemConfig, available services, check_config (Home Assistant)
uptime_monitorslist, get: read only (Uptime Kuma). Pause and resume are not in 2.1.
tunnel_routeslist; add, remove need approval (Cloudflare Tunnel)
dns_filter_statusFilter status and query and block totals (AdGuard Home, read only)
dns_filter_queriesPaged query log (AdGuard Home, read only)
dns_filter_ruleslist blocked services and custom rules; add, remove need approval (AdGuard Home)
sso_applicationslist; create makes a proxy provider and an application for one host, and needs approval (Authentik)

Every tool returns structured data with a published schema, so an assistant can write code against the results. Lists take limit and offset. Every change tool takes dry_run=true, which shows exactly what would change and changes nothing. Errors always look like homelab. . : Fix: .

Skills

Skills are short guides the assistant reads before a job. Homelab ships them in a skills/ folder for apps that read Agent Skills, and serves each one as an MCP prompt for every other client.

Written for Homelab

SkillWhat it covers
getting-startedWhich modules are on, the settings each needs, the first checks, how approvals work
expose-a-service-safelyPut one container on a public name: dry run, approval, per-hop diagnosis, outside check
homelab-health-checkA read-only sweep of modules, containers, certificates, monitors and DNS filtering
homelab-troubleshootingRoot-cause investigation for a failing service, one hypothesis at a time
fix-and-deploy

ตัดมาแค่ช่วงต้น อ่านต่อใน repo