Gemini PC Workspace
Connects Google Gemini on the web to a local computer workspace, enabling it to list, read, and write files and run whitelisted safe commands such as checking Git status or listing directories.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
🤖 Gemini PC Workspace (Custom MCP Server)
เชื่อมต่อ 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 | คำอธิบาย | ตัวอย่างการสั่งในแชท |
| แสดงรายชื่อไฟล์ทั้งหมดในโฟลเดอร์ทำงาน | "ดูรายชื่อไฟล์ทั้งหมดในโฟลเดอร์ทำงานหน่อย" |
| อ่านเนื้อหาไฟล์ข้อความ | "อ่านเนื้อหาในไฟล์ notes.txt ให้ฟังหน่อย" |
| สร้างหรือบันทึกไฟล์ใหม่ลงในเครื่อง | "ช่วยเขียนสรุปแผนงานลงไฟล์ plan.md" |
| รันคำสั่งปลอดภัย ( | "เช็คสถานะ 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 จะทำให้อัตโนมัติทั้งหมด:
ติดตั้งไลบรารีที่ต้องใช้ (เฉพาะครั้งแรก)
สร้างรหัสลับเก็บในไฟล์
.mcp_secret(เฉพาะครั้งแรก ไฟล์นี้ไม่ขึ้น git)เปิด MCP server ที่พอร์ต 8000
เปิด Cloudflare Tunnel แล้วแสดงลิงก์สำหรับเอาไปใส่ใน Gemini บนจอ
โหมด | ใช้เมื่อ | ลิงก์ |
Quick Tunnel (ค่าเริ่มต้น) | ไม่ต้องสมัครอะไร ฟรี |
|
Named Tunnel | มีโดเมนใน Cloudflare อยู่แล้ว อยากได้ลิงก์ถาวร | วาง token ไว้ในไฟล์ |
<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
เปิด Google Gemini (gemini.google.com) แล้วไปที่ แสดงเพิ่ม › ปรับแต่ง › เครื่องมือเชื่อมต่อ › + กำหนดเอง
วางลิงก์
https://.../<secret>/mcpลงในช่อง URL ของเซิร์ฟเวอร์ MCP → กด ถัดไป → ติ๊กยอมรับ → กด เชื่อมต่อถ้าเชื่อมต่อสำเร็จ จะเห็น 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ใหม่แล้วรีสตาร์ท serverMCP อ่านหรือแสดงไม่ได้:
.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…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect AI assistants to your approved computer for files, commands, browser and desktop tasks.
Use your Mac, Windows or Linux computer from ChatGPT, Claude or Codex: files, commands, documents.
Connect ChatGPT, Claude, Cursor or VS Code to your Windows PC: files, terminal, browser, apps.
Connect ChatGPT and Claude to your Mac, Windows or Linux with secure MCP remote access.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables ChatGPT to inspect and edit local projects through a secure MCP interface, offering workspace management, file operations, git integration, and safe command execution.6MIT
- AlicenseNot gradedqualityBmaintenanceEnables Gemini Spark to securely read, edit, and search a selected local workspace, execute shell commands, and integrate development tools via MCP with user approval safeguards.1MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to securely operate on a local workstation through MCP by exposing file, shell, and workspace management tools.10MIT

Flyto2 Runtimeofficial
AlicenseNot gradedqualityBmaintenanceGives ChatGPT secure access to your local machine over MCP, letting it read and edit files, run commands, tests, and Git within approved workspaces.1MIT