Skip to main content
Glama
Gemini PC Workspace

Gemini PC Workspace

by 108ido

🤖 Gemini PC Workspace (Custom MCP Server)

Python 3.10+ License: MIT MCP Protocol

เชื่อมต่อ Google Gemini บนเว็บเข้ากับคอมพิวเตอร์ของคุณโดยตรงผ่าน Model Context Protocol (MCP) สั่งให้ AI อ่านไฟล์, สร้างไฟล์, แก้ไขโค้ด และสั่งรันคำสั่งบนเครื่องได้เหมือนมี JARVIS ประจำตัว!


✨ จุดเด่น (Features)

  • 📂 จัดการไฟล์ในเครื่อง: สั่งให้ Gemini ดูรายชื่อไฟล์, อ่านเนื้อหา, หรือสร้างไฟล์ใหม่ลงในโฟลเดอร์ทำงานบน PC

  • ⚡ One-Click Start: มีไฟล์ start.bat ให้ดับเบิ้ลคลิกเดียว รันทั้งเซิร์ฟเวอร์และเปิด Cloudflare Tunnel อัตโนมัติ

  • 🛡️ ปลอดภัยด้วยระบบ Sandbox: จำกัดสิทธิ์การเข้าถึงไฟล์เฉพาะในโฟลเดอร์ที่กำหนด ป้องกัน Path Traversal

  • 🔒 Command Whitelist: ป้องกันการสั่งคำสั่งอันตราย รันได้เฉพาะคำสั่งปลอดภัยที่อนุญาตเท่านั้น

  • 🌐 ไม่ต้องเปิดพอร์ตเราเตอร์: ใช้งานผ่าน Cloudflare Tunnel (ฟรี 100% ไม่ต้องสมัครสมาชิก ไม่ต้องใช้ IP จริง)

  • 🔄 รองรับ MCP ทุกเวอร์ชัน: มี Compatibility Layer ในตัว แก้ปัญหา ModuleNotFoundError และ DNS Rebinding อัตโนมัติ


Related MCP server: VibeBridge

🛠️ เครื่องมือที่ Gemini สั่งงานได้ (Available Tools)

Tool Name

คำอธิบาย

ตัวอย่างการสั่งในแชท

list_files

แสดงรายชื่อไฟล์ทั้งหมดในโฟลเดอร์ทำงาน

"ดูรายชื่อไฟล์ทั้งหมดในโฟลเดอร์ทำงานหน่อย"

read_file

อ่านเนื้อหาไฟล์ข้อความ

"อ่านเนื้อหาในไฟล์ notes.txt ให้ฟังหน่อย"

write_file

สร้างหรือบันทึกไฟล์ใหม่ลงในเครื่อง

"ช่วยเขียนสรุปแผนงานลงไฟล์ plan.md"

run_allowed_command

รันคำสั่งปลอดภัย (git_status, python_version, list_dir)

"เช็คสถานะ git status ในเครื่องให้ที"


🚀 เริ่มต้นใช้งานใน 3 ขั้นตอน (Quick Start)

ขั้นตอนที่ 1: ดาวน์โหลดโปรเจกต์

git clone https://github.com/108ido/gemini-pc-mcp.git
cd gemini-pc-mcp

ขั้นตอนที่ 2: ดับเบิลคลิก start.bat

ต้องมี Python 3.10+ และ cloudflared ในเครื่องก่อน ถ้ายังไม่มี cloudflared ให้ติดตั้งด้วยคำสั่งนี้:

winget install --id Cloudflare.cloudflared

ตอนรัน start.bat จะทำให้อัตโนมัติทั้งหมด:

  1. ติดตั้งไลบรารีที่ต้องใช้ (เฉพาะครั้งแรก)

  2. สร้างรหัสลับเก็บในไฟล์ .mcp_secret (เฉพาะครั้งแรก ไฟล์นี้ไม่ขึ้น git)

  3. เปิด MCP server ที่พอร์ต 8000

  4. เปิด Cloudflare Tunnel แล้วแสดงลิงก์สำหรับเอาไปใส่ใน Gemini บนจอ

โหมด

ใช้เมื่อ

ลิงก์

Quick Tunnel (ค่าเริ่มต้น)

ไม่ต้องสมัครอะไร ฟรี

https://xxxx.trycloudflare.com/<secret>/mcp (เปลี่ยนทุกครั้งที่เปิดใหม่)

Named Tunnel

มีโดเมนใน Cloudflare อยู่แล้ว อยากได้ลิงก์ถาวร

วาง token ไว้ในไฟล์ .tunnel_token → https://<โดเมนของคุณ>/<secret>/mcp

<secret> = ข้อความในไฟล์ .mcp_secret ซึ่ง start.bat จะแสดงลิงก์เต็มพร้อมรหัสให้บนจออยู่แล้ว

👉 รันเองผ่าน Terminal

pip install -r requirements.txt
python server.py
cloudflared tunnel --url http://127.0.0.1:8000

ขั้นตอนที่ 3: วางลิงก์ใน Google Gemini

  1. เปิด Google Gemini (gemini.google.com) แล้วไปที่ แสดงเพิ่ม › ปรับแต่ง › เครื่องมือเชื่อมต่อ › + กำหนดเอง

  2. วางลิงก์ https://.../<secret>/mcp ลงในช่อง URL ของเซิร์ฟเวอร์ MCP → กด ถัดไป → ติ๊กยอมรับ → กด เชื่อมต่อ

  3. ถ้าเชื่อมต่อสำเร็จ จะเห็น PC Workspace พร้อมเครื่องมือ 6 ตัว จากนั้นลองพิมพ์สั่งใน Gemini ได้เลย เช่น "ใช้ PC Workspace สร้างไฟล์ hello.html …"

ถ้าใช้ Quick Tunnel ลิงก์จะเปลี่ยนทุกครั้งที่เปิด start.bat ใหม่ ต้องลบ connector ตัวเก่าใน Gemini แล้วเพิ่มตัวใหม่ด้วยลิงก์ใหม่ทุกครั้ง


📂 โฟลเดอร์ทำงาน (Workspace)

ค่าเริ่มต้นคือโฟลเดอร์ของโปรเจกต์นี้ ถ้าต้องการเปลี่ยน ให้กำหนดผ่าน Environment Variable MCP_WORKSPACE:

$env:MCP_WORKSPACE = "C:\Your\Custom\Path"
python server.py

⚠️ ความปลอดภัย

  • ถ้าไม่มีรหัสลับ server จะตอบ 404 ทุก request ถ้ารหัสหลุดเมื่อไหร่ ให้สร้าง .mcp_secret ใหม่แล้วรีสตาร์ท server

  • MCP อ่านหรือแสดงไม่ได้: .mcp_secret, .tunnel_token, .git, .env และทุกอย่างที่อยู่นอกโฟลเดอร์ทำงาน

  • MCP เขียนไม่ได้: ไฟล์ที่รันได้ (.py .bat .cmd .ps1 .vbs .js .exe .dll .lnk .reg .scr .msi) กันไม่ให้มีคนเขียน server.py/start.bat ใหม่เพื่อสั่งรันโค้ดบน PC

  • ถ้า token ของ tunnel หลุด ให้ไปกด Refresh token ใน Cloudflare Zero Trust แล้วอัปเดตไฟล์ .tunnel_token


📄 License

โปรเจกต์นี้เผยแพร่ภายใต้สัญญาอนุญาต MIT License สามารถนำไปต่อยอด ดัดแปลง และใช้งานได้ฟรี!

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers