MokoConsulting/mcp-windows
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

feat: implement all 44 MCP tools (v1.0 through v1.4) #41

Merged
jmiller merged 4 commits from dev into main 2026-05-26 02:53:50 +00:00
Conversation 0 Commits 4 Files Changed 31
+4039 -412
jmiller commented 2026-05-26 02:48:43 +00:00
Owner
Copy Link
Copy Source

Summary

  • Replace template API scaffolding with 44 Windows desktop system tools across 22 source modules
  • Core shell executor (shell.ts) with PowerShell/cmd/bash support and persistent terminal sessions
  • Tools cover: terminal execution, process management, audio control, system info, file operations, services, power management, network, drives, display/screenshot, window management, clipboard, notifications, task scheduler, registry, environment variables, startup items, installed apps, dialogs, netstat, and recycle bin
  • Added to global ~/.claude/.mcp.json for Claude Code integration
  • All 40 Gitea issues addressed (some expanded into sub-tools)

Milestones

Milestone Tools Modules
v1.0 Core 14 execute, process, audio, system, terminal, filesystem
v1.1 System Control 9 process_kill, service, audio_apps, power, network, drives
v1.2 Desktop Automation 8 display, window, clipboard, notification
v1.3 Admin Tools 9 scheduler, registry, environment, startup, config
v1.4 Advanced 4 apps, dialog, netstat, recycle_bin
Total 44 22 files

Architecture

  • src/shell.ts -- PowerShell executor + persistent session manager (ring buffer, 5000 line cap)
  • src/tools/.ts -- each module self-registers via registerTools(server)
  • Uses Win32 P/Invoke (via inline C#) for audio COM, window management, display control
  • Clipboard/audio use STA subprocess for COM threading compatibility

Test plan

  • TypeScript compiles cleanly (npx tsc)
  • MCP server initializes and responds to tools/list (44 tools)
  • Smoke test each tool category in a live Claude Code session

Generated with Claude Code

## Summary - Replace template API scaffolding with 44 Windows desktop system tools across 22 source modules - Core shell executor (shell.ts) with PowerShell/cmd/bash support and persistent terminal sessions - Tools cover: terminal execution, process management, audio control, system info, file operations, services, power management, network, drives, display/screenshot, window management, clipboard, notifications, task scheduler, registry, environment variables, startup items, installed apps, dialogs, netstat, and recycle bin - Added to global ~/.claude/.mcp.json for Claude Code integration - All 40 Gitea issues addressed (some expanded into sub-tools) ## Milestones | Milestone | Tools | Modules | |-----------|-------|---------| | v1.0 Core | 14 | execute, process, audio, system, terminal, filesystem | | v1.1 System Control | 9 | process_kill, service, audio_apps, power, network, drives | | v1.2 Desktop Automation | 8 | display, window, clipboard, notification | | v1.3 Admin Tools | 9 | scheduler, registry, environment, startup, config | | v1.4 Advanced | 4 | apps, dialog, netstat, recycle_bin | | **Total** | **44** | **22 files** | ## Architecture - src/shell.ts -- PowerShell executor + persistent session manager (ring buffer, 5000 line cap) - src/tools/*.ts -- each module self-registers via register*Tools(server) - Uses Win32 P/Invoke (via inline C#) for audio COM, window management, display control - Clipboard/audio use STA subprocess for COM threading compatibility ## Test plan - [x] TypeScript compiles cleanly (npx tsc) - [x] MCP server initializes and responds to tools/list (44 tools) - [ ] Smoke test each tool category in a live Claude Code session Generated with [Claude Code](https://claude.com/claude-code)
jmiller added 4 commits 2026-05-26 02:48:43 +00:00
feat: implement v1.0 high-priority tools (14 tools)
Generic: Repo Health / Access control (push) Successful in 1s
Details
Generic: Repo Health / Release configuration (push) Has been cancelled
Details
Generic: Repo Health / Scripts governance (push) Has been cancelled
Details
Generic: Repo Health / Repository health (push) Has been cancelled
Details
03e7ea0e69 
Replace template API scaffolding with Windows desktop system tools:

- shell.ts: PowerShell/cmd/bash executor + persistent terminal sessions
- tools/execute.ts: windows_execute (#1)
- tools/process.ts: windows_process_list (#2)
- tools/audio.ts: windows_audio_get, windows_audio_set (#6, #7)
- tools/system.ts: windows_system_info (#18)
- tools/terminal.ts: windows_terminal_start/send/read/list/kill (#35)
- tools/filesystem.ts: windows_file_read/write/edit, windows_search (#36-39)

Removes template API client/config/types (not needed for local OS MCP).

Authored-by: Moko Consulting
feat: implement v1.1 system control tools (9 new tools)
Generic: Repo Health / Access control (push) Successful in 1s
Details
Generic: Repo Health / Release configuration (push) Has been cancelled
Details
Generic: Repo Health / Scripts governance (push) Has been cancelled
Details
Generic: Repo Health / Repository health (push) Has been cancelled
Details
7cf3dbe420 
- tools/process_kill.ts: windows_process_kill (#3)
- tools/service.ts: windows_service_list, windows_service_control (#4, #5)
- tools/audio_apps.ts: windows_audio_app_volumes (#8)
- tools/power.ts: windows_power_get, windows_power_action (#12, #13)
- tools/network.ts: windows_network_info (#22)
- tools/drives.ts: windows_drives, windows_file_search (#24, #25)

Total: 23 tools registered (v1.0 + v1.1 complete)

Authored-by: Moko Consulting
feat: implement v1.2 desktop automation tools (8 new tools)
Generic: Repo Health / Access control (push) Successful in 1s
Details
Generic: Repo Health / Release configuration (push) Failing after 6s
Details
Generic: Repo Health / Scripts governance (push) Successful in 7s
Details
Generic: Repo Health / Repository health (push) Failing after 8s
Details
2b29940d8e 
- tools/display.ts: windows_display_get, windows_display_set, windows_screenshot (#9-11)
- tools/window.ts: windows_window_list, windows_window_control (#14, #15)
- tools/clipboard.ts: windows_clipboard_get, windows_clipboard_set (#16, #17)
- tools/notification.ts: windows_notification_send (#20)

Uses Win32 P/Invoke for window management and System.Drawing for screenshots.
Clipboard uses STA PowerShell subprocess for COM threading.

Total: 31 tools registered (v1.0 + v1.1 + v1.2 complete)

Authored-by: Moko Consulting
feat: implement v1.3 admin tools + v1.4 advanced (13 new tools)
Generic: Repo Health / Access control (push) Successful in 1s
Details
MCP: Copilot Agent / Run Copilot Coding Agent (pull_request) Failing after 3s
Details
Universal: Changelog Validation / Validate CHANGELOG.md (pull_request) Failing after 6s
Details
Universal: Secret Scanning / Gitleaks Secret Scan (pull_request) Successful in 7s
Details
Universal: PR Check / Branch Policy (pull_request) Successful in 4s
Details
Generic: Repo Health / Access control (pull_request) Successful in 3s
Details
Universal: PR Check / Validate PR (pull_request) Failing after 6s
Details
Universal: PR Check / Changelog Updated (pull_request) Failing after 5s
Details
MCP: Build & Validate / build (20) (pull_request) Failing after 15s
Details
MCP: Standards Compliance / Secret Scanning (pull_request) Successful in 6s
Details
MCP: Build & Validate / build (22) (pull_request) Failing after 16s
Details
MCP: Standards Compliance / License Header Validation (pull_request) Failing after 5s
Details
MCP: Standards Compliance / Repository Structure Validation (pull_request) Failing after 5s
Details
MCP: Standards Compliance / Coding Standards Check (pull_request) Failing after 5s
Details
MCP: Standards Compliance / Workflow Configuration Check (pull_request) Failing after 6s
Details
MCP: Standards Compliance / Documentation Quality Check (pull_request) Failing after 6s
Details
MCP: Standards Compliance / Git Repository Hygiene (pull_request) Successful in 5s
Details
MCP: Standards Compliance / README Completeness Check (pull_request) Failing after 5s
Details
MCP: Standards Compliance / File Naming Standards (pull_request) Successful in 5s
Details
MCP: Standards Compliance / Insecure Code Pattern Detection (pull_request) Successful in 4s
Details
MCP: Standards Compliance / Line Length Check (pull_request) Failing after 7s
Details
MCP: Standards Compliance / File Size Limits (pull_request) Successful in 5s
Details
MCP: Standards Compliance / Script Integrity Validation (pull_request) Successful in 11s
Details
MCP: Standards Compliance / Binary File Detection (pull_request) Successful in 6s
Details
MCP: Standards Compliance / TODO/FIXME Tracking (pull_request) Successful in 4s
Details
MCP: Standards Compliance / Dead Code Detection (pull_request) Successful in 6s
Details
MCP: Standards Compliance / Broken Link Detection (pull_request) Successful in 6s
Details
MCP: Standards Compliance / API Documentation Coverage (pull_request) Successful in 6s
Details
MCP: Standards Compliance / Performance Metrics (pull_request) Successful in 6s
Details
MCP: Standards Compliance / Accessibility Check (pull_request) Successful in 6s
Details
Universal: Auto-Assign / Assign unassigned issues and PRs (pull_request_target) Successful in 2s
Details
MCP: Standards Compliance / Version Consistency Check (pull_request) Successful in 1m3s
Details
MCP: Standards Compliance / Code Complexity Analysis (pull_request) Successful in 58s
Details
MCP: Standards Compliance / Code Duplication Detection (pull_request) Successful in 59s
Details
Universal: CodeQL Analysis / Analyze (actions) (pull_request) Failing after 1m28s
Details
MCP: Standards Compliance / Terraform Configuration Validation (pull_request) Successful in 23s
Details
Universal: CodeQL Analysis / Analyze (javascript) (pull_request) Failing after 1m28s
Details
MCP: Standards Compliance / Unused Dependencies Check (pull_request) Successful in 57s
Details
MCP: Standards Compliance / Enterprise Readiness Check (pull_request) Successful in 53s
Details
MCP: Standards Compliance / Repository Health Check (pull_request) Successful in 54s
Details
Universal: CodeQL Analysis / Security Scan Summary (pull_request) Successful in 3s
Details
MCP: Standards Compliance / Dependency Vulnerability Scanning (pull_request) Successful in 1m44s
Details
MCP: Standards Compliance / Compliance Summary (pull_request) Failing after 2s
Details
Universal: Build & Release / Build & Release Pipeline (pull_request) Failing after 22s
Details
Generic: Repo Health / Release configuration (pull_request) Failing after 5s
Details
Generic: Repo Health / Scripts governance (pull_request) Successful in 6s
Details
Generic: Repo Health / Repository health (pull_request) Failing after 8s
Details
Generic: Repo Health / Release configuration (push) Has been cancelled
Details
Generic: Repo Health / Scripts governance (push) Has been cancelled
Details
Generic: Repo Health / Repository health (push) Has been cancelled
Details
032c50aa46 
v1.3 — Admin Tools:
- tools/scheduler.ts: windows_task_scheduler_list, _manage (#27, #28)
- tools/registry.ts: windows_registry_read, _write (#29, #30)
- tools/environment.ts: windows_env_get, _set (#31, #32)
- tools/startup.ts: windows_startup_list, _manage (#33, #34)
- tools/config.ts: windows_mcp_config (#40)

v1.4 — Advanced:
- tools/apps.ts: windows_installed_apps (#19)
- tools/dialog.ts: windows_dialog (#21)
- tools/netstat.ts: windows_network_connections (#23)
- tools/recycle_bin.ts: windows_recycle_bin (#26)

All 40 issues implemented. 44 tools total (some issues split into
sub-tools like terminal_start/send/read/list/kill).

Authored-by: Moko Consulting
jmiller merged commit ca1b37e91d into main 2026-05-26 02:53:50 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
Clear labels
category: audio
Audio and volume control
 category: bluetooth
Bluetooth management
 category: clipboard
Clipboard operations
 category: config
MCP configuration
 category: display
Display and monitor
 category: environment
Environment variables
 category: features
Windows optional features
 category: filesystem
File system operations
 category: hardware
USB, printers, hardware devices
 category: maintenance
Updates, restore points, event logs
 category: network
Network operations
 category: notification
Notifications and UI
 category: packages
Package management (winget)
 category: power
Power management
 category: registry
Windows Registry
 category: scheduler
Scheduled tasks
 category: security
Firewall, certificates, security
 category: sharing
File sharing and SMB
 category: startup
Startup and autorun
 category: storage
Disk and storage management
 category: system
System information
 category: terminal
Terminal and process execution
 category: theme
Theme and appearance
 category: time
Time, timezone, and locale
 category: wifi
Wi-Fi network management
 category: window
Window management
 category: wsl
Windows Subsystem for Linux
 milestone: v1.0
Core features
 milestone: v1.1
System control
 milestone: v1.2
Desktop automation
 milestone: v1.3
Admin tools
 milestone: v1.4
Advanced features
 milestone: v2.0
Connectivity and hardware
 milestone: v2.1
Appearance and desktop
 milestone: v2.2
Security and maintenance
 milestone: v3.0
WSL and package management
 milestone: v3.1
Storage and system management
 milestone: v3.2
Automation and advanced
bug
Something is not working
 chore
Maintenance and housekeeping
 documentation
Documentation improvements
 enhancement
Improvement to existing functionality
 feature
New feature or request
 pending: dependency
Blocked by another issue or external dependency
 pending: deployment
Tested and approved, awaiting deployment to production
 pending: design
Needs UI/UX or architecture design before implementation
 pending: documentation
Feature works, needs documentation/wiki update
 pending: feedback
Awaiting feedback or decision from stakeholder
 pending: review
Implementation complete, awaiting code review
 pending: testing
Feature implemented but not yet tested
 priority: critical
Must fix immediately
 priority: high
Should fix soon
 priority: low
Nice to have
 priority: medium
Fix when convenient
 refactor
Code restructuring without behavior change
 roadmap
Planned feature or enhancement tracked on the roadmap
 scope: client
Client-specific work
 scope: dolibarr
Dolibarr modules and customizations
 scope: infrastructure
Server, CI, backups, monitoring
 scope: joomla
Joomla templates and extensions
 scope: waas
MokoWaaS platform
 security
Security vulnerability or hardening
 status: blocked
Waiting on external dependency
 status: duplicate
Duplicate of another issue
 status: in-progress
Being worked on
 status: needs-review
Ready for review
 status: wontfix
Will not be addressed
No labels
Type —
Status —
Priority —
Milestone
No items
No Milestone
Assignees
Clear assignees
jmiller (Jonathan Miller)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: MokoConsulting/mcp-windows#41
Delete Branch "dev"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?