mcp-win-stdio 0.2.4__tar.gz → 0.3.0__tar.gz

mcp_win_stdio-0.3.0/.agents/mcp_config.json

@@ -0,0 +1,73 @@
+{
+  "mcpServers": {
+    "excel": {
+      "command": "mws",
+      "args": [
+        "run",
+        "excel"
+      ]
+    },
+    "word": {
+      "command": "mws",
+      "args": [
+        "run",
+        "word"
+      ]
+    },
+    "explorer": {
+      "command": "mws",
+      "args": [
+        "run",
+        "explorer"
+      ],
+      "env": {
+        "EXPLORER_ROOT": "${workspaceFolder}"
+      }
+    },
+    "tsc": {
+      "command": "mws",
+      "args": [
+        "run",
+        "tsc"
+      ],
+      "env": {
+        "TSC_WATCH_DIR": "${workspaceFolder}"
+      }
+    },
+    "db": {
+      "command": "mws",
+      "args": [
+        "run",
+        "db"
+      ]
+    },
+    "git": {
+      "command": "mws",
+      "args": [
+        "run",
+        "git"
+      ]
+    },
+    "ssh": {
+      "command": "mws",
+      "args": [
+        "run",
+        "ssh"
+      ]
+    },
+    "rag": {
+      "command": "mws",
+      "args": [
+        "run",
+        "rag"
+      ]
+    },
+    "excel-db": {
+      "command": "mws",
+      "args": [
+        "run",
+        "excel-db"
+      ]
+    }
+  }
+}

{mcp_win_stdio-0.2.4 → mcp_win_stdio-0.3.0}/.github/workflows/ci.yml

@@ -15,7 +15,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [windows-latest, ubuntu-latest]
-        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
 
     steps:
       - name: Check out repository
@@ -30,14 +30,12 @@ jobs:
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install mcp rapidfuzz pathspec openpyxl pandas python-docx psycopg2-binary pymysql paramiko cryptography build twine pytest
+          pip install mcp rapidfuzz pathspec openpyxl pandas python-docx psycopg2-binary pymysql paramiko cryptography sqlalchemy playwright networkx numpy build twine pytest hatchling
           pip install -e .
+          pip install -e packages/mcp-win-stdio-excel -e packages/mcp-win-stdio-word -e packages/mcp-win-stdio-explorer -e packages/mcp-win-stdio-tsc -e packages/mcp-win-stdio-db -e packages/mcp-win-stdio-git -e packages/mcp-win-stdio-ssh -e packages/mcp-win-stdio-rag -e packages/mcp-win-stdio-excel-db
 
-      - name: Run CLI and Discovery Tests
-        run: python tests/test_cli.py
-
-      - name: Run Audit & Server Engine Tests
-        run: python tests/test_audit.py
+      - name: Run Test Suite
+        run: pytest
 
   build-validation:
     name: Validate Wheel & Sdist Builds
@@ -55,8 +53,9 @@ jobs:
       - name: Install build tools
         run: pip install --upgrade build twine hatchling
 
-      - name: Build all 8 packages
+      - name: Build all 10 packages
         run: python scripts/build_all.py
 
       - name: Validate distribution packages with Twine
         run: twine check dist/*
+

{mcp_win_stdio-0.2.4 → mcp_win_stdio-0.3.0}/.gitignore

@@ -23,6 +23,9 @@ MANIFEST
 
 *.manifest
 *.spec
+api.txt
+pypi-api.txt
+
 
 pip-log.txt
 pip-delete-this-directory.txt

mcp_win_stdio-0.3.0/.mcp.json

@@ -0,0 +1,73 @@
+{
+  "mcpServers": {
+    "excel": {
+      "command": "mws",
+      "args": [
+        "run",
+        "excel"
+      ]
+    },
+    "word": {
+      "command": "mws",
+      "args": [
+        "run",
+        "word"
+      ]
+    },
+    "explorer": {
+      "command": "mws",
+      "args": [
+        "run",
+        "explorer"
+      ],
+      "env": {
+        "EXPLORER_ROOT": "${workspaceFolder}"
+      }
+    },
+    "tsc": {
+      "command": "mws",
+      "args": [
+        "run",
+        "tsc"
+      ],
+      "env": {
+        "TSC_WATCH_DIR": "${workspaceFolder}"
+      }
+    },
+    "db": {
+      "command": "mws",
+      "args": [
+        "run",
+        "db"
+      ]
+    },
+    "git": {
+      "command": "mws",
+      "args": [
+        "run",
+        "git"
+      ]
+    },
+    "ssh": {
+      "command": "mws",
+      "args": [
+        "run",
+        "ssh"
+      ]
+    },
+    "rag": {
+      "command": "mws",
+      "args": [
+        "run",
+        "rag"
+      ]
+    },
+    "excel-db": {
+      "command": "mws",
+      "args": [
+        "run",
+        "excel-db"
+      ]
+    }
+  }
+}

mcp_win_stdio-0.3.0/AGENTS.md

@@ -0,0 +1,16 @@
+# Repository Agent Guidelines
+
+This repository is equipped with the **mcp-win-stdio (`mws`)** tool suite.
+
+## 🛠️ Active Tools & Recommended Selection
+
+* **Unified On-Demand Gateway:** Use `mws` MCP (`list_servers`, `search_tools`, `call_tool`) to route and execute tools on-demand with zero context bloat.
+* **Spreadsheets & Excel:** Use `excel` MCP (`preview_sheet`, `update_cells`, `profile_sheet`).
+* **Word Documents:** Use `word` MCP for typography, layout, and document generation.
+* **Code Navigation:** Use `explorer` MCP (`get_directory_tree`, `fuzzy_find`, `grep_search`).
+* **TypeScript:** Use `tsc` MCP for 0ms compiler diagnostic checks.
+* **Database Operations:** Use `db` MCP (`read_query`, `execute_query`, `describe_table`).
+* **Git & PRs:** Use `git` MCP for status, diffs, commits, and GitHub API interactions.
+* **Remote Shells:** Use `ssh` MCP for multi-host pooling and SFTP.
+* **Documentation & Web RAG:** Use `rag` MCP (`crawl_and_index_url`, `query_knowledge_base`, `get_knowledge_tree`).
+* **High-Speed Pipelines & Streaming:** Use `excel-db` MCP (`db_to_excel_stream`, `excel_to_db_upsert`, `query_unified_sources`, `reconcile_db_vs_excel`).

mcp_win_stdio-0.3.0/GEMINI.md

@@ -0,0 +1,16 @@
+# Repository Agent Guidelines
+
+This repository is equipped with the **mcp-win-stdio (`mws`)** tool suite.
+
+## 🛠️ Active Tools & Recommended Selection
+
+* **Unified On-Demand Gateway:** Use `mws` MCP (`list_servers`, `search_tools`, `call_tool`) to route and execute tools on-demand with zero context bloat.
+* **Spreadsheets & Excel:** Use `excel` MCP (`preview_sheet`, `update_cells`, `profile_sheet`).
+* **Word Documents:** Use `word` MCP for typography, layout, and document generation.
+* **Code Navigation:** Use `explorer` MCP (`get_directory_tree`, `fuzzy_find`, `grep_search`).
+* **TypeScript:** Use `tsc` MCP for 0ms compiler diagnostic checks.
+* **Database Operations:** Use `db` MCP (`read_query`, `execute_query`, `describe_table`).
+* **Git & PRs:** Use `git` MCP for status, diffs, commits, and GitHub API interactions.
+* **Remote Shells:** Use `ssh` MCP for multi-host pooling and SFTP.
+* **Documentation & Web RAG:** Use `rag` MCP (`crawl_and_index_url`, `query_knowledge_base`, `get_knowledge_tree`).
+* **High-Speed Pipelines & Streaming:** Use `excel-db` MCP (`db_to_excel_stream`, `excel_to_db_upsert`, `query_unified_sources`, `reconcile_db_vs_excel`).

mcp_win_stdio-0.2.4/README.md → mcp_win_stdio-0.3.0/PKG-INFO

@@ -1,3 +1,61 @@
+Metadata-Version: 2.5
+Name: mcp-win-stdio
+Version: 0.3.0
+Summary: Windows-optimized Model Context Protocol (MCP) suite & interactive CLI hub for Claude Desktop & Claude Code CLI (Excel COM, Word layouts, Workspace Explorer, and TypeScript diagnostic watcher).
+Author: Mohan Kumar Indala
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,claude,excel,llm,mcp,stdio,typescript,windows,word,workspace-explorer
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Requires-Dist: mcp>=1.2.0
+Provides-Extra: all
+Requires-Dist: mcp-win-stdio-db>=0.3.0; extra == 'all'
+Requires-Dist: mcp-win-stdio-excel-db>=0.3.0; extra == 'all'
+Requires-Dist: mcp-win-stdio-excel>=0.3.0; extra == 'all'
+Requires-Dist: mcp-win-stdio-explorer>=0.3.0; extra == 'all'
+Requires-Dist: mcp-win-stdio-git>=0.3.0; extra == 'all'
+Requires-Dist: mcp-win-stdio-rag>=0.3.0; extra == 'all'
+Requires-Dist: mcp-win-stdio-ssh>=0.3.0; extra == 'all'
+Requires-Dist: mcp-win-stdio-tsc>=0.3.0; extra == 'all'
+Requires-Dist: mcp-win-stdio-word>=0.3.0; extra == 'all'
+Provides-Extra: db
+Requires-Dist: mcp-win-stdio-db>=0.3.0; extra == 'db'
+Provides-Extra: dev
+Requires-Dist: build>=1.2.0; extra == 'dev'
+Requires-Dist: hatchling>=1.25.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.9.0; extra == 'dev'
+Requires-Dist: twine>=5.0.0; extra == 'dev'
+Provides-Extra: excel
+Requires-Dist: mcp-win-stdio-excel>=0.3.0; extra == 'excel'
+Provides-Extra: excel-db
+Requires-Dist: mcp-win-stdio-excel-db>=0.3.0; extra == 'excel-db'
+Provides-Extra: explorer
+Requires-Dist: mcp-win-stdio-explorer>=0.3.0; extra == 'explorer'
+Provides-Extra: git
+Requires-Dist: mcp-win-stdio-git>=0.3.0; extra == 'git'
+Provides-Extra: rag
+Requires-Dist: mcp-win-stdio-rag>=0.3.0; extra == 'rag'
+Provides-Extra: ssh
+Requires-Dist: mcp-win-stdio-ssh>=0.3.0; extra == 'ssh'
+Provides-Extra: tsc
+Requires-Dist: mcp-win-stdio-tsc>=0.3.0; extra == 'tsc'
+Provides-Extra: word
+Requires-Dist: mcp-win-stdio-word>=0.3.0; extra == 'word'
+Description-Content-Type: text/markdown
+
 # mcp-win-stdio
 
 Windows-optimized **Model Context Protocol (MCP)** suite and interactive CLI hub (`mws`) for local `stdio` execution with transparent Claude Desktop & Claude Code CLI configuration.
@@ -8,18 +66,23 @@ Windows-optimized **Model Context Protocol (MCP)** suite and interactive CLI hub
 
 ---
 
-## 🌟 Highlights (130 Tools Across 7 Modular Servers)
+## 🌟 Highlights (220+ Tools Across 10 Modular Servers)
 
+* **Unified On-Demand Gateway Server (`mws server`)**: Configure just `mws server` (or `python -m mcp_win_stdio.server`) in Claude Desktop, Cursor, or Antigravity. Instead of dumping 200+ tools (30,000+ tokens) into the context window, it exposes 6 lightweight meta-tools (~400 tokens) that lazily spawn, cache, and proxy child servers on demand!
+* **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 (`SERVERS`, `DATABASE_URL`, `TSC_WATCH_DIR`) required in client configs!
 * **Interactive CLI Hub (`mws`)**: Run `mws` alone to view all servers, live installation status (`[Installed]` vs `[Not Installed]`), and quick commands.
-* **Safe, Transparent Setup (`mws setup <server>` / `mws add <server>`)**: Installs missing dependencies on-demand, generates exact copy-pasteable JSON configuration for Claude Desktop and Claude Code CLI, and asks confirmation before making any automated edits (always creating `.bak` backups).
-* **Dynamic Guide Merging (`mws guide [server]`)**: View comprehensive tool schemas, prompt recipes, and diagnostic checks for individual servers (`mws ssh guide`, `mws git guide`, `mws db guide`) or all installed servers merged (`mws guide all`).
-* **Multi-SSH & Remote Management MCP (27 Tools)**: Advanced multi-host connection pooling, auto-discovery of `~/.ssh/config` aliases/identity files/ProxyJump, sticky active host routing, command execution, elevated `sudo` automation, interactive PTY terminal sessions, detached background jobs, systemd/docker/pm2 service inspection, package listing, log tailing, comprehensive SFTP file management, and background local port forwarding tunnels.
-* **Git & GitHub MCP (33 Tools)**: Unified local Git repository management (init, remotes, restore, bookmarks, branching, commits, paginated diffs, conflicts) and remote GitHub CLI (`gh`) operations (PR checks, releases, issues, Actions) with hybrid synergy workflows.
-* **Polyglot Database MCP (23 Tools)**: Unified PostgreSQL & MySQL database manager with cross-database switching, cross-schema auto-resolution, fast JSON queries, DBA administrative operations (safety-guarded DROP, CREATE, CLONE), active connection monitoring, index health audits, schema diffing, and native dump/restore utilities.
-* **Excel MCP (20 Tools)**: High-speed Pandas data queries, multi-column reconciliation with RapidFuzz, cell & formula editing, and native Windows Excel COM automation (PDF exports, recalculation, pivot refreshes, VBA macros).
-* **Word MCP (10 Tools)**: Multi-unit page layout geometry (margins in inches, cm, mm, pt), multi-column layout analysis, paragraph spacing/indentation, typography (fonts, sizes, hex colors), and floating/inline header image extraction.
-* **Workspace Explorer MCP (11 Tools)**: Token-safe directory exploration, collapsible heavy folders (`node_modules`, `.next`, `.git`), dynamic `.gitignore` parsing, in-file regex grep, RapidFuzz fuzzy search, and Python/TypeScript AST outline extraction.
-* **TypeScript Diagnostic Watcher MCP (6 Tools)**: Persistent background `tsc` compiler watchers maintaining an in-memory cache for instantaneous (0ms latency) error inspection across multi-tsconfig projects.
+* **Agent-Ready Project Bootstrap (`mws init`)**: Sets up installed servers for the current project, creates client-readable MCP and agent guidance files, adds safe `.env.example` scaffolding, and preserves user-authored files. Supports Codex, Antigravity, Claude, Copilot, Cursor, and Windsurf.
+* **Safe Global Setup (`mws setup <server>` / `mws add <server>`)**: Installs missing dependencies on-demand and guides registration with Claude Desktop and Claude Code CLI.
+* **Dynamic Guide Merging (`mws guide [server]`)**: View comprehensive tool schemas, prompt recipes, and diagnostic checks for individual servers (`mws excel-db guide`, `mws ssh guide`, `mws git guide`, `mws db guide`) or all installed servers merged (`mws guide all`).
+* **Excel MCP (44 Tools)**: High-speed Pandas data queries, multi-column reconciliation with RapidFuzz, native styled Excel Tables (ListObjects), row/column structural mutations, formula templates, cell merging, workbook diffing, and native Windows Excel COM automation (PDF exports, recalculation, pivot refreshes, VBA macros).
+* **Git & GitHub MCP (46 Tools)**: Unified local Git repository management (init, remotes, restore, bookmarks, branching, commits, paginated diffs, conflicts) and remote GitHub CLI (`gh`) operations (PR checks, releases, issues, Actions) with hybrid synergy workflows.
+* **Multi-SSH & Remote Management MCP (34 Tools)**: Advanced multi-host connection pooling, auto-discovery of `~/.ssh/config` aliases/identity files/ProxyJump, sticky active host routing, command execution, elevated `sudo` automation, interactive PTY terminal sessions, detached background jobs, systemd/docker/pm2 service inspection, package listing, log tailing, comprehensive SFTP file management, and background local port forwarding tunnels.
+* **Polyglot Database MCP (34 Tools)**: Unified PostgreSQL & MySQL database manager with dynamic connection hub (`~/.mcp-win-stdio/db_connections.json` shared with `excel-db`), cross-database switching, cross-schema auto-resolution, fast JSON queries, DBA administrative operations (safety-guarded DROP, CREATE, CLONE), active connection monitoring, index health audits, schema diffing with migration SQL, Mermaid ERD diagrams, row-level data diffing, slow queries, lock blocking trees, CSV/JSON streaming export, and transactional batch CSV import.
+* **Word MCP (20 Tools)**: Multi-unit page layout geometry (margins in inches, cm, mm, pt), multi-column layout analysis, paragraph spacing/indentation, typography (fonts, sizes, hex colors), floating/inline header image extraction, document authoring, template placeholder filling, and native Word COM PDF export.
+* **Workspace Explorer MCP (14 Tools)**: Token-safe directory exploration, collapsible heavy folders (`node_modules`, `.next`, `.git`), dynamic `.gitignore` parsing, in-file regex grep, RapidFuzz fuzzy search, and Python/TypeScript AST outline extraction.
+* **Excel & DB Power Engine MCP (9 Tools)**: Zero-context streaming from database to Excel, chunked Excel-to-DB upserting, in-memory cross-source SQL joins, automated reconciliation diffs, multi-master datasets comparison with tolerance, transactional migration generation, and custom Python template pipelines.
+* **TypeScript Diagnostic Watcher MCP (12 Tools)**: Persistent background `tsc` compiler watchers maintaining an in-memory cache for instantaneous (0ms latency) error inspection, dynamic multi-project workspace configuration (`list_projects`, `use_project`, `add_project`, `remove_project`), and actionable error fixes.
+* **RAG MCP (10 Tools)**: Multi-collection web crawling, incremental local and zero-clone remote repository indexing, hybrid BM25 + TF-IDF search, related-chunk discovery, full-context retrieval, knowledge trees, and cache lifecycle management.
 * **Extensible User Plugins**: Drop any standalone Python MCP script into `~/.mcp-win-stdio/plugins/` and it is immediately discovered, runnable, and configurable.
 
 ---
@@ -30,23 +93,28 @@ Each server is published as an independent, lightweight PyPI package. Installing
 
 | Server | Standalone Package | Tools | Primary Capabilities |
 | :--- | :--- | :---: | :--- |
-| **SSH** | `pip install mcp-win-stdio-ssh` | 27 | Multi-host pooling, ~/.ssh/config discovery, PTY shells, background jobs, systemd/docker, package management, SFTP, port forwarding |
-| **Git & GitHub** | `pip install mcp-win-stdio-git` | 33 | Local Git init/remotes/restore/bookmarks/branches, commits, diffs + GitHub PR checks, releases, issues, Actions |
-| **Database** | `pip install mcp-win-stdio-db` | 23 | PostgreSQL & MySQL pooling, cross-schema resolution, index audits, schema diffs, DBA management, dump/restore |
-| **Excel** | `pip install mcp-win-stdio-excel` | 20 | Pandas queries, RapidFuzz reconciliation, OpenPyXL, native Excel COM automation |
-| **Word** | `pip install mcp-win-stdio-word` | 10 | Margins (in, cm, mm, pt), multi-column IEEE layout, typography, image extraction |
-| **Explorer** | `pip install mcp-win-stdio-explorer` | 11 | Token-safe tree, .gitignore resolution, in-file grep, AST outlines |
-| **TypeScript** | `pip install mcp-win-stdio-tsc` | 6 | 0ms in-memory compilation error cache, multi-tsconfig watchers |
+| **mws Server** | `pip install mcp-win-stdio` | 6 | Unified On-Demand Gateway & Dynamic Process Orchestrator (loads all servers on-demand, anti-bloat) |
+| **Excel** | `pip install mcp-win-stdio-excel` | 44 | Native Excel Tables, row/col mutations, formulas, Pandas queries, RapidFuzz reconciliation, Office COM automation |
+| **Git & GitHub** | `pip install mcp-win-stdio-git` | 46 | Local Git init/remotes/restore/bookmarks/branches, commits, diffs + GitHub PR checks, releases, issues, Actions |
+| **SSH** | `pip install mcp-win-stdio-ssh` | 34 | Multi-host pooling, ~/.ssh/config discovery, PTY shells, background jobs, systemd/docker, package management, SFTP, tunnels |
+| **Database** | `pip install mcp-win-stdio-db` | 34 | PostgreSQL & MySQL dynamic pooling, ~/.mcp-win-stdio config, cross-schema resolution, index audits, schema diffs, Mermaid ERD, slow queries, lock trees |
+| **Word** | `pip install mcp-win-stdio-word` | 20 | Margins (in, cm, mm, pt), multi-column layout, typography, document authoring, template filling, Office COM PDF export |
+| **Explorer** | `pip install mcp-win-stdio-explorer` | 14 | Token-safe collapsible tree, .gitignore resolution, in-file grep, AST outlines, fuzzy search |
+| **Excel & DB** | `pip install mcp-win-stdio-excel-db` | 9 | Zero-context streaming, cross-joins, master reconciliation with tolerance, transactional migration plan, dry-run sync |
+| **TypeScript** | `pip install mcp-win-stdio-tsc` | 12 | 0ms in-memory compilation error cache, dynamic multi-project config (add_project/use_project), multi-tsconfig watchers, fix suggestions |
+| **RAG** | `pip install mcp-win-stdio-rag` | 10 | Web crawling, local/remote repo indexing, hybrid BM25 + TF-IDF search, context and collection lifecycle |
 
 ### Install Individual Servers:
 ```powershell
-pip install mcp-win-stdio-ssh
+pip install mcp-win-stdio-excel
 pip install mcp-win-stdio-git
+pip install mcp-win-stdio-ssh
 pip install mcp-win-stdio-db
-pip install mcp-win-stdio-excel
 pip install mcp-win-stdio-word
 pip install mcp-win-stdio-explorer
+pip install mcp-win-stdio-excel-db
 pip install mcp-win-stdio-tsc
+pip install mcp-win-stdio-rag
 ```
 
 ### Or Install the Complete Suite:
@@ -72,7 +140,7 @@ mws
 Output:
 ```text
 ============================================================================
-   🚀  mcp-win-stdio — Windows Model Context Protocol Suite (v0.2.4)
+   🚀  mcp-win-stdio — Windows Model Context Protocol Suite (v0.3.0)
 ============================================================================
 
  Single-Source Hub:      C:\Users\admin\.mcp-win-stdio
@@ -93,7 +161,7 @@ git          [Installed]      26       26 tools: Local Git branching, co...
    mws guide <server>    -> View complete tool reference & Claude prompts
    mws doctor            -> Run health checks (COM, Python, DB, Git)
    mws run <server>      -> Launch MCP server over stdio
-   mws list              -> List all servers and custom plugins
+   mws list              -> Show concise server inventory
 ============================================================================
 ```
 
@@ -111,10 +179,14 @@ mws add db
 
 | Command | Shorthand / Alternate Syntax | Description |
 | :--- | :--- | :--- |
-| `mws` | `mws list` | Displays interactive terminal home dashboard with live server status, PyPI update alerts, and tips. |
+| `mws` | — | Opens the home dashboard with suite health, Claude client status, server overview, and quick commands. |
+| `mws list` | — | Shows a focused inventory of built-in servers and custom plugins with install status and tool counts. |
 | `mws install <server\|all>` | `mws <server> install` | Installs standalone server packages from PyPI. |
 | `mws update <server\|all>` | `mws <server> update` | Checks PyPI for new versions and upgrades the suite or specific server. |
 | `mws setup <server>` | `mws add <server>` / `mws <server> setup` | Guides setup, verifies dependencies, and generates Claude config snippets. |
+| `mws init [servers...]` | `mws init codex [servers...]` | Bootstraps the current project for installed MCP servers; a client name configures that agent too. |
+| `mws setup-project <servers...>` | `mws add-project <servers...>` | Adds or updates selected MCP servers in current-project configuration. |
+| `mws status` | — | Reports project MCP configuration, installed servers, and environment readiness without changing files. |
 | `mws remove <server>` | `mws <server> remove` | Safely removes server(s) from Claude Desktop and CLI configs. |
 | `mws uninstall <server\|all>` | `mws <server> uninstall` | Cleanly uninstalls packages and removes Claude registrations while preserving your single-source hub (`~/.mcp-win-stdio`). |
 | `mws guide [server]` | `mws <server> guide` | Prints tool reference, parameter schemas, and prompt recipes for Claude. |
@@ -131,6 +203,24 @@ mws add db
 > python -m mcp_win_stdio doctor
 > ```
 
+### What does `mws init` do versus `mws setup`?
+
+* `mws init` (alias `mws init-project`) is **interactive project bootstrap**. It shows the target workspace and servers and asks before writing project config. It defaults to installed servers, then offers environment prompts for selected servers (for example a hidden `DATABASE_URL` prompt for `db`). Secrets are stored in ignored `.env`; `.env.example` stays secret-free. Use `--yes` to confirm without prompts. Existing project MCP entries and user-authored agent instructions are preserved.
+* `mws setup <server>` (also `mws add <server>`) is **machine/client setup** for Claude Desktop and Claude Code. It checks or installs that server's package requirements and guides registration in Claude's user-level configuration. It does not bootstrap the current repository.
+* `mws setup-project <servers...>` (also `mws add-project`) is the **incremental project operation**: it asks before adding only the named servers and their environment settings, without selecting all installed servers. `mws remove-project <servers...>` removes selected project registrations.
+
+Examples:
+```powershell
+mws init                         # Review installed servers, confirm, then bootstrap project
+mws init db                      # Confirm project setup; prompt for DATABASE_URL
+mws init codex rag explorer      # Confirm those servers and configure Codex
+mws setup rag                    # Install/check RAG and configure Claude
+mws setup-project db             # Confirm and add only DB to this project
+mws init db --yes                # Non-interactive; uses existing env/config without prompting
+mws init db --dry-run            # Preview project changes without writing files
+mws status                       # Inspect project/server/environment readiness
+```
+
 
 ---
 
@@ -168,8 +258,9 @@ mws add db
 * **Code Intelligence**: `get_code_outline` (AST extractor for Python classes/methods and JS/TS signatures), `get_file_info`, `workspace_summary`, `export_tree_to_file`.
 * **Safe Reading**: `read_file` (windowed line slicing, binary safeguard), `read_head_tail`.
 
-### ⚡ 6. TypeScript Diagnostic Watcher MCP (`mcp_win_stdio.tsc`) — 6 Tools
-* **Instant Diagnostic Query**: `get_tsc_errors` (0ms in-memory cache), `get_file_errors`, `get_error_summary`.
+### ⚡ 6. TypeScript Diagnostic Watcher MCP (`mcp_win_stdio.tsc`) — 12 Tools
+* **Dynamic Multi-Project Config**: `list_projects`, `use_project(alias_or_path)`, `add_project(path, alias)`, `remove_project(alias_or_path)`.
+* **Instant Diagnostic Query**: `get_tsc_errors` (0ms in-memory cache), `get_file_errors`, `get_error_summary`, `get_error_category_breakdown`, `suggest_error_fixes`.
 * **Dynamic Watchers**: `list_watched_projects`, `watch_project(path)`, `restart_tsc_watcher`.
 
 ---
@@ -182,7 +273,7 @@ Simply place your script into:
 %USERPROFILE%\.mcp-win-stdio\plugins\my_custom_mcp.py
 ```
 `mcp-win-stdio` automatically discovers it:
-* View it in `mws list`
+* View it in `mws list` (or use `mws` for the full dashboard)
 * Run it via `mws run my_custom_mcp`
 * Add it to Claude via `mws setup my_custom_mcp`