ekran-rehberi
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.
🧭 Ekran Rehberi · Screen Guide
Claude points. You click. A tiny Windows overlay that shows where to click, copy, paste or drag, with colored boxes, short labels and a ghost cursor, step by step. Built to help people with ADHD stay focused.
🇬🇧 English · 🇹🇷 Türkçe
⭐ If this helps you, please give it a star. It helps other people find it.
💡 Why?
You ask an AI for help and get back: "Open the folder, copy the file, go to the page, click Upload, drag it in…" Then you're left staring at the screen wondering where all that is.
Screen Guide puts the instructions on your screen, one step at a time:
🟩 1. Copy the logo: a green box around the file and a
Ctrl+Cbadge🟦 2. Click Upload: a blue box, and a ghost cursor shows you the click
🟧 3. Drag it here: the ghost cursor carries the file from A to B
✅ When you finish a step it turns green and the next one appears by itself
You stay in control: the guide only shows, and you do the clicking.
Related MCP server: screenmcp-claude-plugin
✨ Features
🎯 One step at a time | Big number, ≤ 6-word label, nothing else to distract you |
🎨 A color per action | click 🟦 · copy 🟩 · paste 🟨 · drag 🟧 · type 🟪 · look ⬜ |
👻 Ghost cursor | Shows the movement, and you follow it with your own mouse |
⚡ Auto-advance | Detects the click, copy, paste, drag or typing and moves on |
🔍 Finds things by name |
|
🪶 Low token usage | Claude sends all steps in one call, and tracking runs locally |
🤖 Opens automatically | The MCP server tells Claude to use it whenever you have manual steps |
🌍 Turkish & English UI | Follows your Windows language. Adding a new language takes one dictionary |
⚙️ How it works
flowchart LR
A[You ask Claude] --> B[Claude answers<br/>+ calls rehber_goster]
B --> C[MCP server]
C -->|localhost JSON| D[Overlay app]
D --> E[UI Automation<br/>finds 'Upload']
E --> F[🟦 box + ghost cursor]
F --> G{You did it?}
G -->|click / copy / paste / drag| H[✅ next step]
G -->|I'm stuck| I[Claude takes ONE screenshot<br/>and fixes the box]🚀 Install (Windows 10/11)
git clone https://github.com/semihcarter5/ekran-rehberi.gitcd ekran-rehberipython -m venv .venv.venv\Scripts\pip install -r requirements.txtConnect to Claude Code
claude mcp add ekran-rehberi -s user -- "C:\FULL\PATH\ekran-rehberi\.venv\Scripts\python.exe" "C:\FULL\PATH\ekran-rehberi\mcp_sunucu.py"Connect to Claude Desktop
Add this to %APPDATA%\Claude\claude_desktop_config.json:
{
"mcpServers": {
"ekran-rehberi": {
"command": "C:\\FULL\\PATH\\ekran-rehberi\\.venv\\Scripts\\python.exe",
"args": ["C:\\FULL\\PATH\\ekran-rehberi\\mcp_sunucu.py"]
}
}
}That's it. The overlay starts in the background the first time it's needed.
🧪 Try it without Claude
.venv\Scripts\python goster.py ornekler\demo.jsonCommand | What it does |
| Show the steps |
| Current step / status |
| Skip to the next step |
| Clear the screen |
| Quit the overlay |
Shortcuts: Ctrl+Shift+Space next step · Ctrl+Shift+End close · drag the panel to move it.
Language: set EKRAN_REHBERI_DIL=en or tr to override the Windows language.
📝 Step format
{
"baslik": "Upload the logo",
"adimlar": [
{"tur": "kopyala", "yazi": "Copy the logo", "hedef": "Explorer > logo.png"},
{"tur": "tikla", "yazi": "Click Upload", "hedef": "Chrome > Upload|Yükle"},
{"tur": "surukle", "yazi": "Drag it here", "hedef": "Explorer > logo.png", "birak": "Chrome > Drag files here"},
{"tur": "yaz", "yazi": "Type the name", "hedef": "Chrome > Repository name", "metin": "my-project"}
]
}tur(type):tiklaclick ·kopyalacopy ·yapistirpaste ·surukledrag ·yaztype ·baklook. English aliases (click,copy,paste,drag,type,look) work too.hedef(target):"Window > visible text". Use|for alternatives:"Taskbar > Başlat|Start".kutu(box):[x, y, width, height]in real screen pixels, when you know the exact spot.
🤝 Contributing: help wanted!
This project is small, friendly and looking for contributors: first-timers are very welcome.
🐛 Found a bug? Open an issue
💡 Have an idea? Start a discussion
🛠️ Want to code? Pick a
good first issue
Ideas we'd love help with: macOS / Linux support, more languages, sound cues, a settings window,
a one-file .exe release, and accessibility testing.
👉 Read the contributing guide. It explains the code (including the Turkish names) in 5 minutes.
🔒 Privacy
Everything runs locally. Mouse and keyboard listeners only check whether the current step is done. Nothing is recorded or sent anywhere.
📄 License
MIT: free to use, change and share.
⭐ Don't forget to star the repo!
Every star helps more people (and more people with ADHD) find this tool.
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 ChatGPT, Claude, Cursor or VS Code to your Windows PC: files, terminal, browser, apps.
Eyes and hands on real Windows PCs — observe, click, type via Glasswarp API.
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.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables Claude to fully control a Windows desktop with native screen capture, low-level input injection, game-grade input, and play-testing capabilities.4MIT
- AlicenseNot gradedqualityDmaintenanceEnables Claude to control the local desktop via screenshot, mouse, keyboard, and clipboard operations.MIT
- AlicenseNot gradedqualityDmaintenanceEnables Claude Desktop to control mouse, keyboard, and clipboard on Windows, allowing AI-driven computer interaction tasks like clicking, typing, scrolling, and screenshotting.MIT
- AlicenseNot gradedqualityCmaintenanceEnables an assistant to visually monitor a selected desktop window through screenshots and perform mouse and keyboard actions, with visual feedback for each step.MIT