ใช้ทำอะไรได้
ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ
- ต่อแบบ ติดตั้งในเครื่อง
- บัญชีหรือคีย์ ต้องมี 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 ทำงานแบบนี้ ใช้ร่วมกับตัวนี้ได้
andrej-karpathy-skills
andrej-karpathy-skills เป็นไฟล์ CLAUDE.md ไฟล์เดียวที่ใช้ปรับพฤติกรรมของ Claude Code ให้ดีขึ้น โดยอ้างอิงจากข้อสังเกตของ Andrej Karpathy เกี่ยวกับข้อผิดพลาดที่พบบ่อยเมื่อ LLM เขียนโค้ด
ทำไมอยู่อันดับนี้
หน้ารายการเรียงด้วยคะแนนการใช้งาน (เต็ม 100) จากส่วนเหล่านี้
| ความนิยม | 0/80 | ดาว GitHub หรือยอดดาวน์โหลดต่อสัปดาห์ ค่ามากนับ 60 ค่าน้อยนับ 20 |
|---|---|---|
| ความสด | 12/12 | ออกรุ่นหรือแก้โค้ดใน 30 วัน ได้เต็ม |
| ระบบยังตอบ | 0/8 | endpoint บนคลาวด์ตอบตอนตรวจล่าสุด |
| คะแนนการใช้งาน | 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 ตัวไหน
เลือกแอปที่คุณใช้ ขั้นตอนจะขึ้นด้านล่าง
ให้ 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 จะบอกให้คุณวางเองในไฟล์หรือช่องของแอป
ลง 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 ดาวน์โหลดให้เองเมื่อต้องใช้
ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น:
uv --versionลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ uv
สมัครและสร้างคีย์ของ Homelab Infra MCP
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ
วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง
เปิดไฟล์ตั้งค่าของแอป Claude บนคอม
SettingsDeveloperEdit Config
วางค่าตั้งนี้แล้วบันทึกไฟล์
{ "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": "ใส่ค่าของคุณ" } } } }วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
ปิดแอป Claude แล้วเปิดใหม่
ลองเลย
ใช้ 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:81HOMELAB_PROXY_EMAILอีเมลผู้ดูแลระบบของ Nginx Proxy Managerดูต้นฉบับภาษาอังกฤษ
Nginx Proxy Manager admin emailHOMELAB_DOCKER_HOSTที่อยู่ของ Docker engine เช่น unix:///var/run/docker.sockดูต้นฉบับภาษาอังกฤษ
Docker engine address, e.g. unix:///var/run/docker.sockHOMELAB_DOCKER_PORTAINER_URLURL พื้นฐานของ Portainer ใช้แทน Docker socketดูต้นฉบับภาษาอังกฤษ
Portainer base URL, instead of the Docker socketHOMELAB_DOCKER_PORTAINER_ENDPOINT_IDรหัส endpoint ของ Portainer (ค่าเริ่มต้น 1)ดูต้นฉบับภาษาอังกฤษ
Portainer endpoint id (default 1)HOMELAB_DNS_ZONE_IDรหัส zone ของ Cloudflare เริ่มต้นดูต้นฉบับภาษาอังกฤษ
Default Cloudflare zone idHOMELAB_HOME_ASSISTANT_URLที่อยู่ของ Home Assistant (โมดูลนี้ปิดอยู่โดยค่าเริ่มต้น)ดูต้นฉบับภาษาอังกฤษ
Home Assistant address (module is off by default)HOMELAB_UPTIME_ENABLEDtrue เปิดใช้งานโมดูล Uptime Kuma (ปิดเป็นค่าเริ่มต้น)ดูต้นฉบับภาษาอังกฤษ
true turns on the Uptime Kuma module (off by default)HOMELAB_UPTIME_URLที่อยู่ของ Uptime Kumaดูต้นฉบับภาษาอังกฤษ
Uptime Kuma addressHOMELAB_TUNNEL_ENABLEDtrue เปิดใช้งานโมดูล Cloudflare Tunnel (ปิดเป็นค่าเริ่มต้น)ดูต้นฉบับภาษาอังกฤษ
true turns on the Cloudflare Tunnel module (off by default)HOMELAB_TUNNEL_ACCOUNT_IDรหัสบัญชี Cloudflare ที่เป็นเจ้าของ tunnelดูต้นฉบับภาษาอังกฤษ
Cloudflare account id that owns the tunnelHOMELAB_TUNNEL_TUNNEL_IDรหัส Cloudflare Tunnelดูต้นฉบับภาษาอังกฤษ
Cloudflare Tunnel idHOMELAB_DNS_FILTER_ENABLEDtrue เปิดใช้งานโมดูล AdGuard Home (ปิดไว้เป็นค่าเริ่มต้น)ดูต้นฉบับภาษาอังกฤษ
true turns on the AdGuard Home module (off by default)HOMELAB_DNS_FILTER_URLที่อยู่ของ AdGuard Homeดูต้นฉบับภาษาอังกฤษ
AdGuard Home addressHOMELAB_DNS_FILTER_USERNAMEชื่อผู้ใช้ของ AdGuard Homeดูต้นฉบับภาษาอังกฤษ
AdGuard Home loginHOMELAB_SSO_ENABLEDtrue เปิดใช้งานโมดูล Authentik (ปิดไว้เป็นค่าเริ่มต้น)ดูต้นฉบับภาษาอังกฤษ
true turns on the Authentik module (off by default)HOMELAB_SSO_URLที่อยู่ของ Authentikดูต้นฉบับภาษาอังกฤษ
Authentik addressHOMELAB_SSO_FLOW_SLUGslug ของโฟลว์การอนุญาตของ Authentik ที่ใช้กับผู้ให้บริการพร็อกซีใหม่ดูต้นฉบับภาษาอังกฤษ
Authentik authorization flow slug used for new proxy providersHOMELAB_READ_ONLYtrue จะปฏิเสธทุกการเปลี่ยนแปลงดูต้นฉบับภาษาอังกฤษ
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 ได้
เลือกจากตัวที่ใช้มากในหมวดเดียวกัน เฉพาะตัวที่ต่อด้วยที่อยู่ได้โดยไม่ต้องใส่คีย์
- Sentry✓ ChatGPT
- Compiler Explorer✓ ChatGPT
- GitDiagram✓ 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 จะบอกให้คุณวางเองในไฟล์หรือช่องของแอป
ลง 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 ดาวน์โหลดให้เองเมื่อต้องใช้
ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น:
uv --versionลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ uv
สมัครและสร้างคีย์ของ Homelab Infra MCP
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ
วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง
เปิด Terminal
Mac: กด Command+Space พิมพ์ Terminal · Windows: เปิด PowerShell
วางคำสั่งนี้แล้วกด 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
วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
พิมพ์ /mcp ใน Claude Code
ต้องเห็น Homelab Infra MCP ในรายการและขึ้นว่าเชื่อมต่อแล้ว
ลองเลย
ใช้ 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:81HOMELAB_PROXY_EMAILอีเมลผู้ดูแลระบบของ Nginx Proxy Managerดูต้นฉบับภาษาอังกฤษ
Nginx Proxy Manager admin emailHOMELAB_DOCKER_HOSTที่อยู่ของ Docker engine เช่น unix:///var/run/docker.sockดูต้นฉบับภาษาอังกฤษ
Docker engine address, e.g. unix:///var/run/docker.sockHOMELAB_DOCKER_PORTAINER_URLURL พื้นฐานของ Portainer ใช้แทน Docker socketดูต้นฉบับภาษาอังกฤษ
Portainer base URL, instead of the Docker socketHOMELAB_DOCKER_PORTAINER_ENDPOINT_IDรหัส endpoint ของ Portainer (ค่าเริ่มต้น 1)ดูต้นฉบับภาษาอังกฤษ
Portainer endpoint id (default 1)HOMELAB_DNS_ZONE_IDรหัส zone ของ Cloudflare เริ่มต้นดูต้นฉบับภาษาอังกฤษ
Default Cloudflare zone idHOMELAB_HOME_ASSISTANT_URLที่อยู่ของ Home Assistant (โมดูลนี้ปิดอยู่โดยค่าเริ่มต้น)ดูต้นฉบับภาษาอังกฤษ
Home Assistant address (module is off by default)HOMELAB_UPTIME_ENABLEDtrue เปิดใช้งานโมดูล Uptime Kuma (ปิดเป็นค่าเริ่มต้น)ดูต้นฉบับภาษาอังกฤษ
true turns on the Uptime Kuma module (off by default)HOMELAB_UPTIME_URLที่อยู่ของ Uptime Kumaดูต้นฉบับภาษาอังกฤษ
Uptime Kuma addressHOMELAB_TUNNEL_ENABLEDtrue เปิดใช้งานโมดูล Cloudflare Tunnel (ปิดเป็นค่าเริ่มต้น)ดูต้นฉบับภาษาอังกฤษ
true turns on the Cloudflare Tunnel module (off by default)HOMELAB_TUNNEL_ACCOUNT_IDรหัสบัญชี Cloudflare ที่เป็นเจ้าของ tunnelดูต้นฉบับภาษาอังกฤษ
Cloudflare account id that owns the tunnelHOMELAB_TUNNEL_TUNNEL_IDรหัส Cloudflare Tunnelดูต้นฉบับภาษาอังกฤษ
Cloudflare Tunnel idHOMELAB_DNS_FILTER_ENABLEDtrue เปิดใช้งานโมดูล AdGuard Home (ปิดไว้เป็นค่าเริ่มต้น)ดูต้นฉบับภาษาอังกฤษ
true turns on the AdGuard Home module (off by default)HOMELAB_DNS_FILTER_URLที่อยู่ของ AdGuard Homeดูต้นฉบับภาษาอังกฤษ
AdGuard Home addressHOMELAB_DNS_FILTER_USERNAMEชื่อผู้ใช้ของ AdGuard Homeดูต้นฉบับภาษาอังกฤษ
AdGuard Home loginHOMELAB_SSO_ENABLEDtrue เปิดใช้งานโมดูล Authentik (ปิดไว้เป็นค่าเริ่มต้น)ดูต้นฉบับภาษาอังกฤษ
true turns on the Authentik module (off by default)HOMELAB_SSO_URLที่อยู่ของ Authentikดูต้นฉบับภาษาอังกฤษ
Authentik addressHOMELAB_SSO_FLOW_SLUGslug ของโฟลว์การอนุญาตของ Authentik ที่ใช้กับผู้ให้บริการพร็อกซีใหม่ดูต้นฉบับภาษาอังกฤษ
Authentik authorization flow slug used for new proxy providersHOMELAB_READ_ONLYtrue จะปฏิเสธทุกการเปลี่ยนแปลงดูต้นฉบับภาษาอังกฤษ
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 จะบอกให้คุณวางเองในไฟล์หรือช่องของแอป
ลง 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 ดาวน์โหลดให้เองเมื่อต้องใช้
ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น:
uv --versionลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ uv
สมัครและสร้างคีย์ของ Homelab Infra MCP
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ
วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง
ใส่คีย์ในช่องที่ว่างไว้
ในค่าตั้งของ 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 ยังว่าง ใส่คีย์ของคุณแล้วบันทึก
วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
เปิดแชตของ AI ใน Cursor โหมด Agent
ลองเลย
ใช้ 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:81HOMELAB_PROXY_EMAILอีเมลผู้ดูแลระบบของ Nginx Proxy Managerดูต้นฉบับภาษาอังกฤษ
Nginx Proxy Manager admin emailHOMELAB_DOCKER_HOSTที่อยู่ของ Docker engine เช่น unix:///var/run/docker.sockดูต้นฉบับภาษาอังกฤษ
Docker engine address, e.g. unix:///var/run/docker.sockHOMELAB_DOCKER_PORTAINER_URLURL พื้นฐานของ Portainer ใช้แทน Docker socketดูต้นฉบับภาษาอังกฤษ
Portainer base URL, instead of the Docker socketHOMELAB_DOCKER_PORTAINER_ENDPOINT_IDรหัส endpoint ของ Portainer (ค่าเริ่มต้น 1)ดูต้นฉบับภาษาอังกฤษ
Portainer endpoint id (default 1)HOMELAB_DNS_ZONE_IDรหัส zone ของ Cloudflare เริ่มต้นดูต้นฉบับภาษาอังกฤษ
Default Cloudflare zone idHOMELAB_HOME_ASSISTANT_URLที่อยู่ของ Home Assistant (โมดูลนี้ปิดอยู่โดยค่าเริ่มต้น)ดูต้นฉบับภาษาอังกฤษ
Home Assistant address (module is off by default)HOMELAB_UPTIME_ENABLEDtrue เปิดใช้งานโมดูล Uptime Kuma (ปิดเป็นค่าเริ่มต้น)ดูต้นฉบับภาษาอังกฤษ
true turns on the Uptime Kuma module (off by default)HOMELAB_UPTIME_URLที่อยู่ของ Uptime Kumaดูต้นฉบับภาษาอังกฤษ
Uptime Kuma addressHOMELAB_TUNNEL_ENABLEDtrue เปิดใช้งานโมดูล Cloudflare Tunnel (ปิดเป็นค่าเริ่มต้น)ดูต้นฉบับภาษาอังกฤษ
true turns on the Cloudflare Tunnel module (off by default)HOMELAB_TUNNEL_ACCOUNT_IDรหัสบัญชี Cloudflare ที่เป็นเจ้าของ tunnelดูต้นฉบับภาษาอังกฤษ
Cloudflare account id that owns the tunnelHOMELAB_TUNNEL_TUNNEL_IDรหัส Cloudflare Tunnelดูต้นฉบับภาษาอังกฤษ
Cloudflare Tunnel idHOMELAB_DNS_FILTER_ENABLEDtrue เปิดใช้งานโมดูล AdGuard Home (ปิดไว้เป็นค่าเริ่มต้น)ดูต้นฉบับภาษาอังกฤษ
true turns on the AdGuard Home module (off by default)HOMELAB_DNS_FILTER_URLที่อยู่ของ AdGuard Homeดูต้นฉบับภาษาอังกฤษ
AdGuard Home addressHOMELAB_DNS_FILTER_USERNAMEชื่อผู้ใช้ของ AdGuard Homeดูต้นฉบับภาษาอังกฤษ
AdGuard Home loginHOMELAB_SSO_ENABLEDtrue เปิดใช้งานโมดูล Authentik (ปิดไว้เป็นค่าเริ่มต้น)ดูต้นฉบับภาษาอังกฤษ
true turns on the Authentik module (off by default)HOMELAB_SSO_URLที่อยู่ของ Authentikดูต้นฉบับภาษาอังกฤษ
Authentik addressHOMELAB_SSO_FLOW_SLUGslug ของโฟลว์การอนุญาตของ Authentik ที่ใช้กับผู้ให้บริการพร็อกซีใหม่ดูต้นฉบับภาษาอังกฤษ
Authentik authorization flow slug used for new proxy providersHOMELAB_READ_ONLYtrue จะปฏิเสธทุกการเปลี่ยนแปลงดูต้นฉบับภาษาอังกฤษ
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 จะบอกให้คุณวางเองในไฟล์หรือช่องของแอป
ลง 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 ดาวน์โหลดให้เองเมื่อต้องใช้
ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น:
uv --versionลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ uv
สมัครและสร้างคีย์ของ Homelab Infra MCP
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ
วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง
ใส่คีย์ในช่องที่ว่างไว้
ในค่าตั้งของ 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 ยังว่าง ใส่คีย์ของคุณแล้วบันทึก
วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
เปิดแชตของ AI ใน VS Code โหมด Agent
ลองเลย
ใช้ 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:81HOMELAB_PROXY_EMAILอีเมลผู้ดูแลระบบของ Nginx Proxy Managerดูต้นฉบับภาษาอังกฤษ
Nginx Proxy Manager admin emailHOMELAB_DOCKER_HOSTที่อยู่ของ Docker engine เช่น unix:///var/run/docker.sockดูต้นฉบับภาษาอังกฤษ
Docker engine address, e.g. unix:///var/run/docker.sockHOMELAB_DOCKER_PORTAINER_URLURL พื้นฐานของ Portainer ใช้แทน Docker socketดูต้นฉบับภาษาอังกฤษ
Portainer base URL, instead of the Docker socketHOMELAB_DOCKER_PORTAINER_ENDPOINT_IDรหัส endpoint ของ Portainer (ค่าเริ่มต้น 1)ดูต้นฉบับภาษาอังกฤษ
Portainer endpoint id (default 1)HOMELAB_DNS_ZONE_IDรหัส zone ของ Cloudflare เริ่มต้นดูต้นฉบับภาษาอังกฤษ
Default Cloudflare zone idHOMELAB_HOME_ASSISTANT_URLที่อยู่ของ Home Assistant (โมดูลนี้ปิดอยู่โดยค่าเริ่มต้น)ดูต้นฉบับภาษาอังกฤษ
Home Assistant address (module is off by default)HOMELAB_UPTIME_ENABLEDtrue เปิดใช้งานโมดูล Uptime Kuma (ปิดเป็นค่าเริ่มต้น)ดูต้นฉบับภาษาอังกฤษ
true turns on the Uptime Kuma module (off by default)HOMELAB_UPTIME_URLที่อยู่ของ Uptime Kumaดูต้นฉบับภาษาอังกฤษ
Uptime Kuma addressHOMELAB_TUNNEL_ENABLEDtrue เปิดใช้งานโมดูล Cloudflare Tunnel (ปิดเป็นค่าเริ่มต้น)ดูต้นฉบับภาษาอังกฤษ
true turns on the Cloudflare Tunnel module (off by default)HOMELAB_TUNNEL_ACCOUNT_IDรหัสบัญชี Cloudflare ที่เป็นเจ้าของ tunnelดูต้นฉบับภาษาอังกฤษ
Cloudflare account id that owns the tunnelHOMELAB_TUNNEL_TUNNEL_IDรหัส Cloudflare Tunnelดูต้นฉบับภาษาอังกฤษ
Cloudflare Tunnel idHOMELAB_DNS_FILTER_ENABLEDtrue เปิดใช้งานโมดูล AdGuard Home (ปิดไว้เป็นค่าเริ่มต้น)ดูต้นฉบับภาษาอังกฤษ
true turns on the AdGuard Home module (off by default)HOMELAB_DNS_FILTER_URLที่อยู่ของ AdGuard Homeดูต้นฉบับภาษาอังกฤษ
AdGuard Home addressHOMELAB_DNS_FILTER_USERNAMEชื่อผู้ใช้ของ AdGuard Homeดูต้นฉบับภาษาอังกฤษ
AdGuard Home loginHOMELAB_SSO_ENABLEDtrue เปิดใช้งานโมดูล Authentik (ปิดไว้เป็นค่าเริ่มต้น)ดูต้นฉบับภาษาอังกฤษ
true turns on the Authentik module (off by default)HOMELAB_SSO_URLที่อยู่ของ Authentikดูต้นฉบับภาษาอังกฤษ
Authentik addressHOMELAB_SSO_FLOW_SLUGslug ของโฟลว์การอนุญาตของ Authentik ที่ใช้กับผู้ให้บริการพร็อกซีใหม่ดูต้นฉบับภาษาอังกฤษ
Authentik authorization flow slug used for new proxy providersHOMELAB_READ_ONLYtrue จะปฏิเสธทุกการเปลี่ยนแปลงดูต้นฉบับภาษาอังกฤษ
true refuses every change
คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ VS Code เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
โปรแกรมอื่นที่ใช้ MCP ได้ เช่น Windsurf, Zed หรือ Gemini CLI มีวิธีเพิ่มต่างกัน ดูวิธีของแต่ละตัวในหน้ารวมโปรแกรม
ค่าตั้งแบบไฟล์ JSON อยู่ในหัวข้อ “สำหรับคนเขียนโค้ด” ด้านล่าง
สำหรับคนเขียนโค้ด: คำสั่ง 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-mcpClaude 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_URLenvที่อยู่ของ Nginx Proxy Manager เช่น http://localhost:81ดูต้นฉบับภาษาอังกฤษ
Nginx Proxy Manager address, e.g. http://localhost:81HOMELAB_PROXY_EMAILenvอีเมลผู้ดูแลระบบของ Nginx Proxy Managerดูต้นฉบับภาษาอังกฤษ
Nginx Proxy Manager admin emailHOMELAB_PROXY_PASSWORDความลับ จำเป็น envรหัสผ่านผู้ดูแลระบบของ Nginx Proxy Managerดูต้นฉบับภาษาอังกฤษ
Nginx Proxy Manager admin passwordHOMELAB_DOCKER_HOSTenvที่อยู่ของ Docker engine เช่น unix:///var/run/docker.sockดูต้นฉบับภาษาอังกฤษ
Docker engine address, e.g. unix:///var/run/docker.sockHOMELAB_DOCKER_PORTAINER_URLenvURL พื้นฐานของ Portainer ใช้แทน Docker socketดูต้นฉบับภาษาอังกฤษ
Portainer base URL, instead of the Docker socketHOMELAB_DOCKER_PORTAINER_TOKENความลับ จำเป็น envAPI key ของ Portainerดูต้นฉบับภาษาอังกฤษ
Portainer API keyHOMELAB_DOCKER_PORTAINER_ENDPOINT_IDenvรหัส endpoint ของ Portainer (ค่าเริ่มต้น 1)ดูต้นฉบับภาษาอังกฤษ
Portainer endpoint id (default 1)HOMELAB_DNS_API_TOKENความลับ จำเป็น envโทเคน API ของ Cloudflare ที่มีสิทธิ์แก้ไข DNSดูต้นฉบับภาษาอังกฤษ
Cloudflare API token with DNS edit permissionHOMELAB_DNS_ZONE_IDenvรหัส zone ของ Cloudflare เริ่มต้นดูต้นฉบับภาษาอังกฤษ
Default Cloudflare zone idHOMELAB_HOME_ASSISTANT_URLenvที่อยู่ของ Home Assistant (โมดูลนี้ปิดอยู่โดยค่าเริ่มต้น)ดูต้นฉบับภาษาอังกฤษ
Home Assistant address (module is off by default)HOMELAB_HOME_ASSISTANT_TOKENความลับ จำเป็น envโทเค็นการเข้าถึงระยะยาวของ Home Assistantดูต้นฉบับภาษาอังกฤษ
Home Assistant long-lived access tokenHOMELAB_UPTIME_ENABLEDenvtrue เปิดใช้งานโมดูล Uptime Kuma (ปิดเป็นค่าเริ่มต้น)ดูต้นฉบับภาษาอังกฤษ
true turns on the Uptime Kuma module (off by default)HOMELAB_UPTIME_URLenvที่อยู่ของ Uptime Kumaดูต้นฉบับภาษาอังกฤษ
Uptime Kuma addressHOMELAB_UPTIME_API_KEYความลับ จำเป็น envคีย์ API ของ Uptime Kuma อ่านจาก /metricsดูต้นฉบับภาษาอังกฤษ
Uptime Kuma API key, read from /metricsHOMELAB_TUNNEL_ENABLEDenvtrue เปิดใช้งานโมดูล 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 permissionHOMELAB_TUNNEL_ACCOUNT_IDenvรหัสบัญชี Cloudflare ที่เป็นเจ้าของ tunnelดูต้นฉบับภาษาอังกฤษ
Cloudflare account id that owns the tunnelHOMELAB_TUNNEL_TUNNEL_IDenvรหัส Cloudflare Tunnelดูต้นฉบับภาษาอังกฤษ
Cloudflare Tunnel idHOMELAB_DNS_FILTER_ENABLEDenvtrue เปิดใช้งานโมดูล AdGuard Home (ปิดไว้เป็นค่าเริ่มต้น)ดูต้นฉบับภาษาอังกฤษ
true turns on the AdGuard Home module (off by default)HOMELAB_DNS_FILTER_URLenvที่อยู่ของ AdGuard Homeดูต้นฉบับภาษาอังกฤษ
AdGuard Home addressHOMELAB_DNS_FILTER_USERNAMEenvชื่อผู้ใช้ของ AdGuard Homeดูต้นฉบับภาษาอังกฤษ
AdGuard Home loginHOMELAB_DNS_FILTER_PASSWORDความลับ จำเป็น envรหัสผ่านของ AdGuard Homeดูต้นฉบับภาษาอังกฤษ
AdGuard Home passwordHOMELAB_SSO_ENABLEDenvtrue เปิดใช้งานโมดูล Authentik (ปิดไว้เป็นค่าเริ่มต้น)ดูต้นฉบับภาษาอังกฤษ
true turns on the Authentik module (off by default)HOMELAB_SSO_URLenvที่อยู่ของ Authentikดูต้นฉบับภาษาอังกฤษ
Authentik addressHOMELAB_SSO_TOKENความลับ จำเป็น envโทเค็น API ของ Authentikดูต้นฉบับภาษาอังกฤษ
Authentik API tokenHOMELAB_SSO_FLOW_SLUGenvslug ของโฟลว์การอนุญาตของ Authentik ที่ใช้กับผู้ให้บริการพร็อกซีใหม่ดูต้นฉบับภาษาอังกฤษ
Authentik authorization flow slug used for new proxy providersHOMELAB_READ_ONLYenvtrue จะปฏิเสธทุกการเปลี่ยนแปลงดูต้นฉบับภาษาอังกฤษ
true refuses every change
คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ
ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README
สรุป
ใช้กับโปรแกรมไหนได้
ดูจากแบบการต่อของ 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
ผู้ทำ: ขอให้ตรวจใหม่ หรือแจ้งข้อมูลผิด
สำหรับผู้ทำ: ติดป้ายใน README
ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้
[](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.
Appllama
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Cloudflare MCP
Cloudflare MCP servers
Omnara
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Repowise
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
| ตัวนี้ Homelab Infra MCP | GitDiagram | Appllama | Cloudflare MCP | Omnara | Repowise | |
|---|---|---|---|---|---|---|
| ทำงานที่ไหน | ต้องลงในเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | มีทั้งบนคลาวด์และแบบลงเครื่อง |
| ต้องใส่คีย์ | ใช่ | ไม่ | ไม่ | ไม่ | ไม่ | ไม่ |
| กด + ใน Claude ได้ | ไม่ | ไม่ | ไม่ | ใช่ | ไม่ | ไม่ |
| ผลตรวจเบื้องต้น | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 5/5 |
| สัญญาอนุญาต | MIT | MIT | MIT | Apache-2.0 | Apache-2.0 | AGPL-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.
| Module | What it does | Status |
|---|---|---|
proxy | Nginx Proxy Manager: proxy hosts, redirections, SSL certificates, access lists | On by default |
docker | Containers, images and volumes through the local Docker socket or Portainer | On by default |
dns | Cloudflare DNS zones and records, and BIND export | On by default |
home_assistant | Entities, automations, scripts and system info in Home Assistant | Off by default, turn on with HOMELAB_HOME_ASSISTANT_ENABLED=true |
uptime | Uptime Kuma monitors: list and read status (read only) | Off by default, turn on with HOMELAB_UPTIME_ENABLED=true |
tunnel | Cloudflare Tunnel routes: list, add and remove | Off by default, turn on with HOMELAB_TUNNEL_ENABLED=true |
dns_filter | AdGuard Home: filter status, query log and filter rules | Off by default, turn on with HOMELAB_DNS_FILTER_ENABLED=true |
sso | Authentik: list applications, create a proxy provider and application for one host | Off 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.
| Variable | Module | What it is |
|---|---|---|
HOMELAB_PROXY_URL | proxy | Nginx Proxy Manager address. Default http://localhost:81. |
HOMELAB_PROXY_EMAIL / HOMELAB_PROXY_PASSWORD | proxy | The NPM admin login used for the API |
HOMELAB_DOCKER_HOST | docker | Docker engine address. Default unix:///var/run/docker.sock. |
HOMELAB_DOCKER_PORTAINER_URL / HOMELAB_DOCKER_PORTAINER_TOKEN | docker | Use Portainer instead of the socket. Both are needed. |
HOMELAB_DOCKER_PORTAINER_ENDPOINT_ID | docker | Portainer endpoint id. Default 1. |
HOMELAB_DNS_API_TOKEN | dns | Cloudflare API token with DNS edit permission on the zone |
HOMELAB_DNS_ZONE_ID | dns | Default zone id, so tools can leave zone_id empty |
HOMELAB_HOME_ASSISTANT_URL | home_assistant | Home Assistant address. Default http://homeassistant.local:8123. |
HOMELAB_HOME_ASSISTANT_TOKEN | home_assistant | Long-lived access token |
HOMELAB_UPTIME_URL | uptime | Uptime Kuma address |
HOMELAB_UPTIME_API_KEY | uptime | Uptime Kuma API key. Read from /metrics, used for list and get. |
HOMELAB_TUNNEL_API_TOKEN | tunnel | Cloudflare API token with tunnel edit permission |
HOMELAB_TUNNEL_ACCOUNT_ID | tunnel | Cloudflare account id that owns the tunnel |
HOMELAB_TUNNEL_TUNNEL_ID | tunnel | Cloudflare Tunnel id |
HOMELAB_DNS_FILTER_URL | dns_filter | AdGuard Home address |
HOMELAB_DNS_FILTER_USERNAME / HOMELAB_DNS_FILTER_PASSWORD | dns_filter | AdGuard Home login |
HOMELAB_SSO_URL | sso | Authentik address |
HOMELAB_SSO_TOKEN | sso | Authentik API token |
HOMELAB_SSO_FLOW_SLUG | sso | Authorization flow slug that new proxy providers use |
HOMELAB_ _ENABLED | any | true or false. Turns a module on or off, e.g. HOMELAB_UPTIME_ENABLED=true. |
HOMELAB_ _ALLOW_WRITES | any | false by default: each change asks you first. true lets the assistant make changes in that module without asking. See Safety. |
HOMELAB_READ_ONLY | all | true refuses every change, whatever else is set. Reads and dry runs still work. |
HOMELAB_ _ _FILE | any | Read a secret from a file instead, e.g. HOMELAB_DNS_API_TOKEN_FILE=/run/secrets/cf_token |
HOMELAB_CONFIG | core | Path to the config file. Default ~/.config/homelab/config.toml. |
HOMELAB_APPROVAL_LOG | core | Path 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" } } } }
| Client | Where the config goes |
|---|---|
| Claude Desktop | claude_desktop_config.json (Settings → Developer → Edit Config) |
| Claude Code | claude 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, others | Any 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.
| Tool | What it does |
|---|---|
homelab_modules | Which modules are on, which settings are missing, and what each tool does. Call this first. |
homelab_health | Connectivity and version for every enabled module |
expose_service | Check a container, add a DNS record (optional), add a proxy host. One approved plan. |
teardown_service | Remove a service's proxy host and optional DNS record. One approved plan. |
service_status | One view of a service: container, proxy hosts, DNS records |
infrastructure_overview | Counts across Docker, the proxy and DNS |
diagnose_service | Read only. Checks each hop from a domain to its service, one row per hop. Returns the first failing hop and its fix. |
proxy_hosts | list, get, create, update, delete proxy hosts |
proxy_redirections | list, create, delete HTTP redirections |
proxy_certificates | list, request a Let's Encrypt certificate |
proxy_access_lists | list, create, delete IP access lists |
docker_containers | list, get, start, stop, restart, remove, logs, stats, prune |
docker_images | list, pull, remove, prune |
docker_inventory | volumes, networks, or Portainer stacks (with a stack's compose file) |
dns_zones | list zones, or export one in BIND format |
dns_records | list, get, create, update, delete records |
ha_entities | list, get, search; call_service, turn_on, turn_off, toggle (Home Assistant) |
ha_automations | list, trigger, reload automations or scripts; create previews automation YAML (Home Assistant) |
ha_system | Config, available services, check_config (Home Assistant) |
uptime_monitors | list, get: read only (Uptime Kuma). Pause and resume are not in 2.1. |
tunnel_routes | list; add, remove need approval (Cloudflare Tunnel) |
dns_filter_status | Filter status and query and block totals (AdGuard Home, read only) |
dns_filter_queries | Paged query log (AdGuard Home, read only) |
dns_filter_rules | list blocked services and custom rules; add, remove need approval (AdGuard Home) |
sso_applications | list; 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
| Skill | What it covers |
|---|---|
getting-started | Which modules are on, the settings each needs, the first checks, how approvals work |
expose-a-service-safely | Put one container on a public name: dry run, approval, per-hop diagnosis, outside check |
homelab-health-check | A read-only sweep of modules, containers, certificates, monitors and DNS filtering |
homelab-troubleshooting | Root-cause investigation for a failing service, one hypothesis at a time |
fix-and-deploy |