mcp-win-stdio

Windows-optimized Model Context Protocol (MCP) suite and non-invasive CLI hub (mws) for local stdio execution and secure remote tunneling across all major AI IDEs, CLI agents, and desktop apps (Gemini, Antigravity, Claude, ChatGPT, Cursor, Kiro, OpenCode, Windsurf, Copilot, Codex).

🌟 Highlights (233+ Audited Tools Across 10 Modular Servers)

• Unified On-Demand Gateway & Workflow Engine (mws server): Configure just mws server (or python -m mcp_win_stdio.server) in Claude Desktop, Cursor, Gemini, or Antigravity. Dynamic discovery, routing, workflows, and lazy child-server startup avoid loading all 200+ tools into the agent context upfront.

• Secure Remote Tunneling & OAuth 2.0 PKCE (mws tunnel): Expose local Windows tools to remote and web-based agents (Claude Web, ChatGPT Custom GPTs, Cursor, MCP Inspector) over encrypted Cloudflare Tunnels with terminal-generated 6-digit Host-Owner Approval PINs, PKCE (S256), and strict permission ceilings.

• MCP Resources & Prompts Gateway: Discover and read child-server resources, resource templates, and rendered prompts through mws, with cursor-based pagination and large-result artifact handling.

• Agent-Synthesized Workflows (.mws/workflows/): AI agents and developers can chain multiple MCP tools into named composite pipelines with argument templating and error halting.

• 100% Dynamic & Zero-Env Architecture: All configurations (databases, TypeScript projects, SSH hosts, Git repositories) are managed interactively and stored in ~/.mcp-win-stdio/. No environment variables required in client configs!

• Universal Multi-Agent Guide (mws guide): Generates tailored copy-paste configuration snippets and exact configuration file paths for 10 major AI agents without mutating user files.

• Cascading Clean Uninstallation (mws uninstall self): Dynamically discovers and purges all installed mcp-win-stdio-* distributions in one atomic batch.

• Git & GitHub MCP (46 Tools): Unified local Git management (init, remotes, restore, bookmarks, branches, commits, diffs) and remote GitHub CLI (gh) operations (PR checks, releases, issues, Actions).

• Excel MCP (44 Tools): High-speed Pandas queries, multi-column reconciliation with RapidFuzz, native Excel Tables, row/col mutations, formulas, cell merging, workbook diffing, and Office COM automation.

• Polyglot Database MCP (36 Tools): PostgreSQL & MySQL manager with dynamic connection hub, AST-validated safe read queries, transaction boundaries, schema diffing with migration SQL, Mermaid ERD, slow queries, and lock trees.

• Multi-SSH MCP (34 Tools): Multi-host connection pooling, auto-discovery of ~/.ssh/config, interactive PTY terminal sessions, detached background jobs, systemd/docker services, SFTP file management, and port forwarding.

• Word MCP (20 Tools): Multi-unit geometry (in, cm, mm, pt), multi-column layout, typography, document authoring, template placeholder filling, and native Word COM PDF export.

• Workspace Explorer MCP (14 Tools): Token-safe directory exploration, collapsible heavy folders, .gitignore resolution, in-file regex grep, RapidFuzz fuzzy search, and Python/TypeScript AST outlines.

• TypeScript Diagnostic Watcher MCP (12 Tools): Persistent background tsc compiler watchers maintaining an in-memory cache for instantaneous (0ms latency) error inspection and actionable fixes.

• RAG MCP (11 Tools): Multi-collection web crawling, incremental local and remote repository indexing, hybrid BM25 + TF-IDF search, and knowledge trees.

• Excel & DB Power Engine MCP (9 Tools): Zero-context streaming from database to Excel, chunked upserting, in-memory cross-source SQL joins, automated reconciliation diffs, and migration planning.

• Architecture Knowledge Graph MCP (5 Tools): Full-stack vertical blueprint flowcharts, execution trace down to storage entities, ERD diagrams, and blast-radius impact analysis.

• Extensible User Plugins: Drop any standalone Python MCP script into ~/.mcp-win-stdio/plugins/ and it is immediately discovered and proxied.

Related MCP server: office-mcp

📦 Modular Architecture & Installation

Each server is published as an independent, lightweight PyPI package. Installing any standalone package automatically installs the mws CLI orchestrator.

Install Individual Servers:

pip install mcp-win-stdio-git
pip install mcp-win-stdio-excel
pip install mcp-win-stdio-db
pip install mcp-win-stdio-ssh
pip install mcp-win-stdio-word
pip install mcp-win-stdio-explorer
pip install mcp-win-stdio-tsc
pip install mcp-win-stdio-rag
pip install mcp-win-stdio-excel-db
pip install mcp-win-stdio-arch

Or Install the Complete Suite:

pip install "mcp-win-stdio[all]"

For Local Development:

git clone https://github.com/indala/mcp-win-stdio.git
cd mcp-win-stdio
pip install -e .

🚀 Quick Start

1. Launch the Interactive Dashboard

mws

Output:

============================================================================
   🚀  mcp-win-stdio — Windows Model Context Protocol Suite (v0.4.7)
============================================================================

 Single-Source Hub:      C:\Users\admin\.mcp-win-stdio
 Claude Desktop Config:  C:\Users\admin\AppData\Roaming\Claude\claude_desktop_config.json
 Claude Code CLI Config: C:\Users\admin\.claude.json
----------------------------------------------------------------------------
SERVER       STATUS           TOOLS    DESCRIPTION
----------------------------------------------------------------------------
git          [Installed]      46       46 tools: Local Git branching, commits, GitHub PRs...
excel        [Installed]      44       44 tools: Pandas queries, RapidFuzz reconciliation...
db           [Installed]      36       36 tools: Polyglot multi-server pooling, AST defense...
ssh          [Installed]      34       34 tools: Multi-host SSH pooling, PTY, SFTP...
word         [Installed]      20       20 tools: Multi-unit margins, tables, typography...
explorer     [Installed]      14       14 tools: Token-safe collapsible tree, AST grep...
tsc          [Installed]      12       12 tools: Background tsc compiler watchers...
rag          [Installed]      11       11 tools: Web crawling, local & remote repo indexing...
excel-db     [Installed]      9        9 tools: Zero-context streaming, cross-joins...
arch         [Installed]      5        5 tools: Full-stack blueprints, execution tracing...
----------------------------------------------------------------------------
 💡 Quick Commands:
   mws guide             -> Universal setup instructions & config snippets
   mws server            -> Run Unified On-Demand Gateway (anti-bloat)
   mws tunnel            -> Expose tools securely to Claude/ChatGPT Web
   mws doctor            -> Run diagnostic health checks (COM, Python, DB, Git)
============================================================================

2. Configure Your AI Client

Use mws guide to inspect tailored configuration snippets without modifying any files:

# Global overview across all agents:
mws guide

# Tailored for a specific client:
mws guide gemini
mws guide claude
mws guide cursor

Simply copy and paste the snippet provided into your AI IDE or desktop agent configuration.

🌐 Remote Access & Cloudflare Tunnels (mws tunnel)

Expose local Windows tools safely to web-based AI platforms like Claude Web, ChatGPT Custom GPTs, Cursor, and MCP Inspector without opening router ports or exposing static IP addresses.

1. Launch with OAuth 2.0 PKCE (Default & Recommended)

mws tunnel

• Host-Owner Proof: When an authorized web client connects, mws displays a one-time 6-digit approval PIN in your terminal. Enter the PIN in the web browser consent window to approve access.

• Permission Clamping: Defaults to --mode read_only. Mutating actions (file writes, database updates, Git commits) are blocked automatically.

2. Launch with a Bearer Token

# Auto-generate a secure 32-byte cryptographic token:
mws tunnel --auth bearer

# Or pass a pre-shared secret:
mws tunnel --auth bearer --token "my-secure-token"

3. Allow Read-Write Access

mws tunnel --mode read_write

For complete documentation on OAuth 2.0 flows, PKCE verification, and connecting web clients, see: 👉 Remote Access & Secure Cloudflare Tunneling Guide 👉 Security Architecture & Defense-in-Depth

📖 CLI Commands Reference

mws follows a zero-mutation, non-invasive philosophy: it never automatically modifies your agent's configuration files behind your back.

🛠️ Complete Server Inventory

For full parameter details, schemas, and usage examples for all 233+ tools, refer to: 👉 Complete MCP Servers & Tools Reference

• Git & GitHub (46 tools): Comprehensive local git state machine, commits, branches, stashes, diffs, blame, and full GitHub CLI actions (PRs, releases, issues).

• Excel (44 tools): Pandas dataframe queries, RapidFuzz 3-tab reconciliation, openpyxl styling, charts, and native Excel COM PDF export.

• Polyglot Database (36 tools): PostgreSQL & MySQL pools, AST-guarded read_query, transaction isolation, index audits, schema diffs with migration scripts.

• Multi-SSH (34 tools): Connection pooling, ~/.ssh/config parsing, interactive PTY terminal emulation, background jobs, SFTP file transfer.

• Word (20 tools): Physical margin geometry (in, cm, mm, pt), typography, tables, template placeholder substitution, and COM PDF export.

• Workspace Explorer (14 tools): Collapsible heavy trees (node_modules), in-file regex grep, RapidFuzz filename search, and AST code outline.

• TypeScript (12 tools): Instant 0ms cached error queries, multi-tsconfig compilation watchers, and suggested diagnostic fixes.

• RAG (11 tools): Documentation web crawling, local/remote codebase chunking, and hybrid BM25 + TF-IDF knowledge base querying.

• Excel & DB Power Engine (9 tools): Zero-context streaming from SQL to Excel, cross-source joins, master reconciliation, and migration plans.

• Architecture Knowledge Graph (5 tools): Full-stack blueprint flowcharts, execution trace down to storage entities, and blast-radius impact analysis.

🔌 Custom Plugins

Drop any custom standalone Python MCP script into:

%USERPROFILE%\.mcp-win-stdio\plugins\my_custom_mcp.py

mcp-win-stdio automatically discovers it:

• View it in mws list (or use mws for the full dashboard)

• Run it directly via mws run my_custom_mcp

• Access it on-demand through the Gateway (mws server)

📚 Detailed Documentation Index

• 🌐 Remote Access & Secure Cloudflare Tunneling

• 🛡️ Security Architecture & Defense-in-Depth

• 📖 Complete MCP Servers & Tools Reference

• 🤖 Repository Agent Guidelines (AGENTS.md)

• 🤝 Contributing Guide

• 🔒 Security Vulnerability Reporting Policy

📜 License

MIT License. Copyright (c) 2026 Mohan Kumar Indala.