mcp-win-stdio 0.2.3__tar.gz → 0.2.4__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- mcp_win_stdio-0.2.4/.github/workflows/ci.yml +62 -0
- mcp_win_stdio-0.2.4/.github/workflows/release.yml +77 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/.gitignore +1 -1
- mcp_win_stdio-0.2.3/README.md → mcp_win_stdio-0.2.4/PKG-INFO +75 -19
- mcp_win_stdio-0.2.3/PKG-INFO → mcp_win_stdio-0.2.4/README.md +29 -62
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-db/pyproject.toml +2 -2
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-db/src/mcp_win_stdio/db/__init__.py +1 -1
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-db/src/mcp_win_stdio/db/guide.py +4 -4
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-excel/pyproject.toml +2 -2
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-excel/src/mcp_win_stdio/excel/__init__.py +1 -1
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-explorer/pyproject.toml +2 -2
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-explorer/src/mcp_win_stdio/explorer/__init__.py +1 -1
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-git/README.md +14 -10
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-git/pyproject.toml +4 -3
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-git/src/mcp_win_stdio/git/__init__.py +1 -1
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-git/src/mcp_win_stdio/git/server.py +795 -164
- mcp_win_stdio-0.2.4/packages/mcp-win-stdio-ssh/README.md +70 -0
- mcp_win_stdio-0.2.4/packages/mcp-win-stdio-ssh/pyproject.toml +44 -0
- mcp_win_stdio-0.2.4/packages/mcp-win-stdio-ssh/src/mcp_win_stdio/ssh/__init__.py +5 -0
- mcp_win_stdio-0.2.4/packages/mcp-win-stdio-ssh/src/mcp_win_stdio/ssh/__main__.py +8 -0
- mcp_win_stdio-0.2.4/packages/mcp-win-stdio-ssh/src/mcp_win_stdio/ssh/cli.py +152 -0
- mcp_win_stdio-0.2.4/packages/mcp-win-stdio-ssh/src/mcp_win_stdio/ssh/connection.py +369 -0
- mcp_win_stdio-0.2.4/packages/mcp-win-stdio-ssh/src/mcp_win_stdio/ssh/guide.py +94 -0
- mcp_win_stdio-0.2.4/packages/mcp-win-stdio-ssh/src/mcp_win_stdio/ssh/pty_session.py +215 -0
- mcp_win_stdio-0.2.4/packages/mcp-win-stdio-ssh/src/mcp_win_stdio/ssh/server.py +1380 -0
- mcp_win_stdio-0.2.4/packages/mcp-win-stdio-ssh/src/mcp_win_stdio/ssh/sftp_ops.py +428 -0
- mcp_win_stdio-0.2.4/packages/mcp-win-stdio-ssh/src/mcp_win_stdio/ssh/tunnels.py +168 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-tsc/pyproject.toml +2 -2
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-tsc/src/mcp_win_stdio/tsc/__init__.py +1 -1
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-tsc/src/mcp_win_stdio/tsc/server.py +118 -25
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-word/pyproject.toml +2 -2
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-word/src/mcp_win_stdio/word/__init__.py +1 -1
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/pyproject.toml +18 -13
- mcp_win_stdio-0.2.4/scripts/build_all.py +66 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/src/mcp_win_stdio/__init__.py +1 -1
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/src/mcp_win_stdio/cli.py +247 -37
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/src/mcp_win_stdio/core/discovery.py +14 -2
- mcp_win_stdio-0.2.4/src/mcp_win_stdio/core/environment.py +180 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/src/mcp_win_stdio/core/installer.py +17 -0
- mcp_win_stdio-0.2.4/src/mcp_win_stdio/core/updater.py +111 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/tests/test_audit.py +111 -8
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/tests/test_cli.py +27 -4
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/tests/test_git.py +113 -12
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/LICENSE +0 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-db/README.md +0 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-db/src/mcp_win_stdio/db/__main__.py +0 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-db/src/mcp_win_stdio/db/cli.py +0 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-db/src/mcp_win_stdio/db/server.py +0 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-excel/README.md +0 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-excel/src/mcp_win_stdio/excel/__main__.py +0 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-excel/src/mcp_win_stdio/excel/cli.py +0 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-excel/src/mcp_win_stdio/excel/guide.py +0 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-excel/src/mcp_win_stdio/excel/server.py +0 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-explorer/README.md +0 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-explorer/src/mcp_win_stdio/explorer/__main__.py +0 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-explorer/src/mcp_win_stdio/explorer/cli.py +0 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-explorer/src/mcp_win_stdio/explorer/guide.py +0 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-explorer/src/mcp_win_stdio/explorer/server.py +0 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-git/src/mcp_win_stdio/git/__main__.py +0 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-git/src/mcp_win_stdio/git/cli.py +0 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-git/src/mcp_win_stdio/git/guide.py +0 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-tsc/README.md +0 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-tsc/src/mcp_win_stdio/tsc/__main__.py +0 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-tsc/src/mcp_win_stdio/tsc/cli.py +0 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-tsc/src/mcp_win_stdio/tsc/guide.py +0 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-word/README.md +0 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-word/src/mcp_win_stdio/word/__main__.py +0 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-word/src/mcp_win_stdio/word/cli.py +0 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-word/src/mcp_win_stdio/word/guide.py +0 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-word/src/mcp_win_stdio/word/server.py +0 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/src/mcp_win_stdio/__main__.py +0 -0
- {mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/src/mcp_win_stdio/core/config.py +0 -0
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
name: CI Test Suite
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
push:
|
|
5
|
+
branches: [ "main" ]
|
|
6
|
+
pull_request:
|
|
7
|
+
branches: [ "main" ]
|
|
8
|
+
workflow_dispatch:
|
|
9
|
+
|
|
10
|
+
jobs:
|
|
11
|
+
test:
|
|
12
|
+
name: Test Python ${{ matrix.python-version }} on ${{ matrix.os }}
|
|
13
|
+
runs-on: ${{ matrix.os }}
|
|
14
|
+
strategy:
|
|
15
|
+
fail-fast: false
|
|
16
|
+
matrix:
|
|
17
|
+
os: [windows-latest, ubuntu-latest]
|
|
18
|
+
python-version: ["3.10", "3.11", "3.12", "3.13"]
|
|
19
|
+
|
|
20
|
+
steps:
|
|
21
|
+
- name: Check out repository
|
|
22
|
+
uses: actions/checkout@v4
|
|
23
|
+
|
|
24
|
+
- name: Set up Python ${{ matrix.python-version }}
|
|
25
|
+
uses: actions/setup-python@v5
|
|
26
|
+
with:
|
|
27
|
+
python-version: ${{ matrix.python-version }}
|
|
28
|
+
cache: "pip"
|
|
29
|
+
|
|
30
|
+
- name: Install dependencies
|
|
31
|
+
run: |
|
|
32
|
+
python -m pip install --upgrade pip
|
|
33
|
+
pip install mcp rapidfuzz pathspec openpyxl pandas python-docx psycopg2-binary pymysql paramiko cryptography build twine pytest
|
|
34
|
+
pip install -e .
|
|
35
|
+
|
|
36
|
+
- name: Run CLI and Discovery Tests
|
|
37
|
+
run: python tests/test_cli.py
|
|
38
|
+
|
|
39
|
+
- name: Run Audit & Server Engine Tests
|
|
40
|
+
run: python tests/test_audit.py
|
|
41
|
+
|
|
42
|
+
build-validation:
|
|
43
|
+
name: Validate Wheel & Sdist Builds
|
|
44
|
+
runs-on: ubuntu-latest
|
|
45
|
+
needs: test
|
|
46
|
+
steps:
|
|
47
|
+
- name: Check out repository
|
|
48
|
+
uses: actions/checkout@v4
|
|
49
|
+
|
|
50
|
+
- name: Set up Python
|
|
51
|
+
uses: actions/setup-python@v5
|
|
52
|
+
with:
|
|
53
|
+
python-version: "3.12"
|
|
54
|
+
|
|
55
|
+
- name: Install build tools
|
|
56
|
+
run: pip install --upgrade build twine hatchling
|
|
57
|
+
|
|
58
|
+
- name: Build all 8 packages
|
|
59
|
+
run: python scripts/build_all.py
|
|
60
|
+
|
|
61
|
+
- name: Validate distribution packages with Twine
|
|
62
|
+
run: twine check dist/*
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
name: Release & Publish to PyPI
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
push:
|
|
5
|
+
tags:
|
|
6
|
+
- "v*"
|
|
7
|
+
branches:
|
|
8
|
+
- "main"
|
|
9
|
+
workflow_dispatch:
|
|
10
|
+
|
|
11
|
+
permissions:
|
|
12
|
+
contents: write
|
|
13
|
+
id-token: write
|
|
14
|
+
|
|
15
|
+
jobs:
|
|
16
|
+
build-and-publish:
|
|
17
|
+
name: Build All 7 Packages & Publish to PyPI
|
|
18
|
+
runs-on: ubuntu-latest
|
|
19
|
+
steps:
|
|
20
|
+
- name: Check out repository
|
|
21
|
+
uses: actions/checkout@v4
|
|
22
|
+
with:
|
|
23
|
+
fetch-depth: 0
|
|
24
|
+
|
|
25
|
+
- name: Set up Python
|
|
26
|
+
uses: actions/setup-python@v5
|
|
27
|
+
with:
|
|
28
|
+
python-version: "3.12"
|
|
29
|
+
|
|
30
|
+
- name: Install build and packaging dependencies
|
|
31
|
+
run: |
|
|
32
|
+
python -m pip install --upgrade pip
|
|
33
|
+
pip install --upgrade build twine hatchling
|
|
34
|
+
|
|
35
|
+
- name: Run Test Suite
|
|
36
|
+
run: |
|
|
37
|
+
pip install mcp rapidfuzz pathspec openpyxl pandas python-docx psycopg2-binary pymysql paramiko cryptography
|
|
38
|
+
python tests/test_cli.py
|
|
39
|
+
python tests/test_audit.py
|
|
40
|
+
|
|
41
|
+
- name: Build All 8 Packages (Root + Subpackages)
|
|
42
|
+
run: python scripts/build_all.py
|
|
43
|
+
|
|
44
|
+
- name: Check Artifact Metadata
|
|
45
|
+
run: twine check dist/*
|
|
46
|
+
|
|
47
|
+
- name: Publish to PyPI
|
|
48
|
+
env:
|
|
49
|
+
TWINE_USERNAME: __token__
|
|
50
|
+
TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
|
|
51
|
+
run: |
|
|
52
|
+
if [ -n "$TWINE_PASSWORD" ]; then
|
|
53
|
+
echo "Publishing packages to PyPI (skipping already published releases)..."
|
|
54
|
+
for f in dist/*; do
|
|
55
|
+
echo "Uploading $f..."
|
|
56
|
+
for attempt in 1 2 3 4 5; do
|
|
57
|
+
if twine upload --skip-existing "$f"; then
|
|
58
|
+
break
|
|
59
|
+
else
|
|
60
|
+
echo "Upload failed (possibly rate limit), retrying in 10s... (attempt $attempt/5)"
|
|
61
|
+
sleep 10
|
|
62
|
+
fi
|
|
63
|
+
done
|
|
64
|
+
sleep 3
|
|
65
|
+
done
|
|
66
|
+
else
|
|
67
|
+
echo "::warning ::PYPI_API_TOKEN secret is not set in GitHub repository settings. Skipping PyPI upload."
|
|
68
|
+
fi
|
|
69
|
+
|
|
70
|
+
- name: Create GitHub Release
|
|
71
|
+
uses: softprops/action-gh-release@v2
|
|
72
|
+
if: startsWith(github.ref, 'refs/tags/v')
|
|
73
|
+
with:
|
|
74
|
+
files: dist/*
|
|
75
|
+
generate_release_notes: true
|
|
76
|
+
draft: false
|
|
77
|
+
prerelease: false
|
|
@@ -1,3 +1,49 @@
|
|
|
1
|
+
Metadata-Version: 2.5
|
|
2
|
+
Name: mcp-win-stdio
|
|
3
|
+
Version: 0.2.4
|
|
4
|
+
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).
|
|
5
|
+
Author: Mohan Kumar Indala
|
|
6
|
+
License-Expression: MIT
|
|
7
|
+
License-File: LICENSE
|
|
8
|
+
Keywords: ai,claude,excel,llm,mcp,stdio,typescript,windows,word,workspace-explorer
|
|
9
|
+
Classifier: Development Status :: 4 - Beta
|
|
10
|
+
Classifier: Environment :: Win32 (MS Windows)
|
|
11
|
+
Classifier: Intended Audience :: Developers
|
|
12
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
13
|
+
Classifier: Operating System :: Microsoft :: Windows
|
|
14
|
+
Classifier: Programming Language :: Python :: 3
|
|
15
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
16
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
19
|
+
Classifier: Programming Language :: Python :: 3.14
|
|
20
|
+
Classifier: Topic :: Software Development :: Libraries
|
|
21
|
+
Requires-Python: >=3.10
|
|
22
|
+
Requires-Dist: mcp>=1.2.0
|
|
23
|
+
Provides-Extra: all
|
|
24
|
+
Requires-Dist: mcp-win-stdio-db>=0.2.4; extra == 'all'
|
|
25
|
+
Requires-Dist: mcp-win-stdio-excel>=0.2.4; extra == 'all'
|
|
26
|
+
Requires-Dist: mcp-win-stdio-explorer>=0.2.4; extra == 'all'
|
|
27
|
+
Requires-Dist: mcp-win-stdio-git>=0.2.4; extra == 'all'
|
|
28
|
+
Requires-Dist: mcp-win-stdio-ssh>=0.2.4; extra == 'all'
|
|
29
|
+
Requires-Dist: mcp-win-stdio-tsc>=0.2.4; extra == 'all'
|
|
30
|
+
Requires-Dist: mcp-win-stdio-word>=0.2.4; extra == 'all'
|
|
31
|
+
Provides-Extra: db
|
|
32
|
+
Requires-Dist: mcp-win-stdio-db>=0.2.4; extra == 'db'
|
|
33
|
+
Provides-Extra: excel
|
|
34
|
+
Requires-Dist: mcp-win-stdio-excel>=0.2.4; extra == 'excel'
|
|
35
|
+
Provides-Extra: explorer
|
|
36
|
+
Requires-Dist: mcp-win-stdio-explorer>=0.2.4; extra == 'explorer'
|
|
37
|
+
Provides-Extra: git
|
|
38
|
+
Requires-Dist: mcp-win-stdio-git>=0.2.4; extra == 'git'
|
|
39
|
+
Provides-Extra: ssh
|
|
40
|
+
Requires-Dist: mcp-win-stdio-ssh>=0.2.4; extra == 'ssh'
|
|
41
|
+
Provides-Extra: tsc
|
|
42
|
+
Requires-Dist: mcp-win-stdio-tsc>=0.2.4; extra == 'tsc'
|
|
43
|
+
Provides-Extra: word
|
|
44
|
+
Requires-Dist: mcp-win-stdio-word>=0.2.4; extra == 'word'
|
|
45
|
+
Description-Content-Type: text/markdown
|
|
46
|
+
|
|
1
47
|
# mcp-win-stdio
|
|
2
48
|
|
|
3
49
|
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,13 +54,14 @@ Windows-optimized **Model Context Protocol (MCP)** suite and interactive CLI hub
|
|
|
8
54
|
|
|
9
55
|
---
|
|
10
56
|
|
|
11
|
-
## 🌟 Highlights (
|
|
57
|
+
## 🌟 Highlights (130 Tools Across 7 Modular Servers)
|
|
12
58
|
|
|
13
59
|
* **Interactive CLI Hub (`mws`)**: Run `mws` alone to view all servers, live installation status (`[Installed]` vs `[Not Installed]`), and quick commands.
|
|
14
60
|
* **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).
|
|
15
|
-
* **Dynamic Guide Merging (`mws guide [server]`)**: View comprehensive tool schemas, prompt recipes, and diagnostic checks for individual servers (`mws git guide`, `mws db guide`) or all installed servers merged (`mws guide all`).
|
|
16
|
-
* **
|
|
17
|
-
* **
|
|
61
|
+
* **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`).
|
|
62
|
+
* **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.
|
|
63
|
+
* **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.
|
|
64
|
+
* **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.
|
|
18
65
|
* **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).
|
|
19
66
|
* **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.
|
|
20
67
|
* **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.
|
|
@@ -29,8 +76,9 @@ Each server is published as an independent, lightweight PyPI package. Installing
|
|
|
29
76
|
|
|
30
77
|
| Server | Standalone Package | Tools | Primary Capabilities |
|
|
31
78
|
| :--- | :--- | :---: | :--- |
|
|
32
|
-
| **
|
|
33
|
-
| **
|
|
79
|
+
| **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 |
|
|
80
|
+
| **Git & GitHub** | `pip install mcp-win-stdio-git` | 33 | Local Git init/remotes/restore/bookmarks/branches, commits, diffs + GitHub PR checks, releases, issues, Actions |
|
|
81
|
+
| **Database** | `pip install mcp-win-stdio-db` | 23 | PostgreSQL & MySQL pooling, cross-schema resolution, index audits, schema diffs, DBA management, dump/restore |
|
|
34
82
|
| **Excel** | `pip install mcp-win-stdio-excel` | 20 | Pandas queries, RapidFuzz reconciliation, OpenPyXL, native Excel COM automation |
|
|
35
83
|
| **Word** | `pip install mcp-win-stdio-word` | 10 | Margins (in, cm, mm, pt), multi-column IEEE layout, typography, image extraction |
|
|
36
84
|
| **Explorer** | `pip install mcp-win-stdio-explorer` | 11 | Token-safe tree, .gitignore resolution, in-file grep, AST outlines |
|
|
@@ -38,6 +86,7 @@ Each server is published as an independent, lightweight PyPI package. Installing
|
|
|
38
86
|
|
|
39
87
|
### Install Individual Servers:
|
|
40
88
|
```powershell
|
|
89
|
+
pip install mcp-win-stdio-ssh
|
|
41
90
|
pip install mcp-win-stdio-git
|
|
42
91
|
pip install mcp-win-stdio-db
|
|
43
92
|
pip install mcp-win-stdio-excel
|
|
@@ -69,7 +118,7 @@ mws
|
|
|
69
118
|
Output:
|
|
70
119
|
```text
|
|
71
120
|
============================================================================
|
|
72
|
-
🚀 mcp-win-stdio — Windows Model Context Protocol Suite (v0.2.
|
|
121
|
+
🚀 mcp-win-stdio — Windows Model Context Protocol Suite (v0.2.4)
|
|
73
122
|
============================================================================
|
|
74
123
|
|
|
75
124
|
Single-Source Hub: C:\Users\admin\.mcp-win-stdio
|
|
@@ -108,36 +157,43 @@ mws add db
|
|
|
108
157
|
|
|
109
158
|
| Command | Shorthand / Alternate Syntax | Description |
|
|
110
159
|
| :--- | :--- | :--- |
|
|
111
|
-
| `mws` | `mws list` | Displays interactive terminal home dashboard with server status and tips. |
|
|
160
|
+
| `mws` | `mws list` | Displays interactive terminal home dashboard with live server status, PyPI update alerts, and tips. |
|
|
161
|
+
| `mws install <server\|all>` | `mws <server> install` | Installs standalone server packages from PyPI. |
|
|
162
|
+
| `mws update <server\|all>` | `mws <server> update` | Checks PyPI for new versions and upgrades the suite or specific server. |
|
|
112
163
|
| `mws setup <server>` | `mws add <server>` / `mws <server> setup` | Guides setup, verifies dependencies, and generates Claude config snippets. |
|
|
113
164
|
| `mws remove <server>` | `mws <server> remove` | Safely removes server(s) from Claude Desktop and CLI configs. |
|
|
165
|
+
| `mws uninstall <server\|all>` | `mws <server> uninstall` | Cleanly uninstalls packages and removes Claude registrations while preserving your single-source hub (`~/.mcp-win-stdio`). |
|
|
114
166
|
| `mws guide [server]` | `mws <server> guide` | Prints tool reference, parameter schemas, and prompt recipes for Claude. |
|
|
115
|
-
| `mws doctor` | `mws <server> doctor` | Runs diagnostic health checks (Python, Git CLI, GitHub CLI, COM, DB drivers). |
|
|
167
|
+
| `mws doctor` | `mws <server> doctor` | Runs diagnostic health checks (Python, Git CLI, GitHub CLI, COM, DB drivers, PyPI updates). |
|
|
168
|
+
| `mws fix-path` | `mws path` | Checks and configures Python Scripts/bin directories in Windows User PATH. |
|
|
116
169
|
| `mws run <server>` | `mws <server> run` | Launches the MCP server over stdio. |
|
|
117
170
|
|
|
171
|
+
|
|
118
172
|
> [!TIP]
|
|
119
173
|
> If `mws` is not yet in Windows `PATH`, all commands can be executed using Python's module runner:
|
|
120
174
|
> ```powershell
|
|
121
175
|
> python -m mcp_win_stdio run git
|
|
122
|
-
> python -m mcp_win_stdio
|
|
176
|
+
> python -m mcp_win_stdio update all
|
|
123
177
|
> python -m mcp_win_stdio doctor
|
|
124
178
|
> ```
|
|
125
179
|
|
|
180
|
+
|
|
126
181
|
---
|
|
127
182
|
|
|
128
|
-
## 🛠️ The 6 MCP Servers (
|
|
183
|
+
## 🛠️ The 6 MCP Servers (103 Tools)
|
|
129
184
|
|
|
130
|
-
### 🐙 1. Git & GitHub MCP (`mcp_win_stdio.git`) —
|
|
131
|
-
* **Local Git Suite (
|
|
132
|
-
* **Remote GitHub CLI Suite (
|
|
133
|
-
* **Hybrid Synergy Workflows (
|
|
185
|
+
### 🐙 1. Git & GitHub MCP (`mcp_win_stdio.git`) — 33 Tools
|
|
186
|
+
* **Local Git Suite (20 Tools)**: `git_init`, `git_remote`, `git_restore`, `use_repo`, `list_repos`, `add_repo`, `remove_repo`, `rename_alias`, `git_status`, `git_diff` (with offset pagination), `git_log`, `git_commit` (with untracked safeguards), `git_branch`, `git_stash`, `git_sync`, `git_blame`, `git_reset`, `git_tag`, `git_grep`, `git_worktree`, `git_config`, `git_conflict_resolve`, `git_cherry_pick`, `git_clean_untracked`.
|
|
187
|
+
* **Remote GitHub CLI Suite (10 Tools)**: `gh_auth_status`, `gh_switch_account`, `gh_pr_list`, `gh_pr_view`, `gh_pr_diff`, `gh_pr_checkout`, `gh_pr_action`, `gh_pr_checks`, `gh_pr_review_comments`, `gh_release_list`, `gh_release_create`, `gh_issue_list`, `gh_issue_view`, `gh_issue_create`, `gh_issue_comment`, `gh_run_status`, `gh_gist_create`, `gh_search`, `gh_api`.
|
|
188
|
+
* **Hybrid Synergy Workflows (3 Tools)**:
|
|
189
|
+
* `repo_overview`: 360-degree status combining local branch, dirty status, ahead/behind tracking, active open PR, and latest GitHub Actions workflow run.
|
|
134
190
|
* `pr_quickstart`: Stage $\rightarrow$ Commit $\rightarrow$ Push $\rightarrow$ Create PR via `gh pr create` in one turn.
|
|
135
191
|
* `issue_start_work`: Fetches issue from GitHub and creates a linked local branch `feature/<id>-<slug>`.
|
|
136
192
|
|
|
137
|
-
### 🗄️ 2. Polyglot Database MCP (`mcp_win_stdio.db`) —
|
|
138
|
-
* **Inspection & Resolution**: `list_connections`, `use_database`, `list_databases`, `list_schemas`, `describe_table` (auto cross-schema lookup), `schema_overview`, `get_table_sample`, `search_schema`.
|
|
139
|
-
* **Execution &
|
|
140
|
-
* **DBA Management**: `create_database`, `drop_database` (safety confirmation required), `clone_database` (instant PostgreSQL TEMPLATE clone), `terminate_connections`, `list_active_queries`.
|
|
193
|
+
### 🗄️ 2. Polyglot Database MCP (`mcp_win_stdio.db`) — 23 Tools
|
|
194
|
+
* **Inspection & Resolution**: `list_connections`, `use_database`, `list_databases`, `list_schemas`, `describe_table` (auto cross-schema lookup), `get_table_ddl`, `schema_overview`, `compact_schema_overview`, `get_table_sample`, `search_schema`.
|
|
195
|
+
* **Execution & Diagnostics**: `read_query` (safe SELECT with row counts), `execute_query` (DML/DDL transactions), `explain_query` (EXPLAIN plans), `get_database_stats`, `analyze_table_indexes`, `compare_schemas` (structural diff with migration SQL), `audit_database_health` (unindexed FKs, bloated tables).
|
|
196
|
+
* **DBA Management**: `add_connection`, `create_database`, `drop_database` (safety confirmation required), `clone_database` (instant PostgreSQL TEMPLATE clone), `terminate_connections`, `list_active_queries`.
|
|
141
197
|
* **Native Utilities**: `dump_database` (`pg_dump`/`mysqldump`), `restore_database` (`psql`/`mysql`).
|
|
142
198
|
|
|
143
199
|
### 📊 3. Excel MCP (`mcp_win_stdio.excel`) — 20 Tools
|
|
@@ -1,46 +1,3 @@
|
|
|
1
|
-
Metadata-Version: 2.5
|
|
2
|
-
Name: mcp-win-stdio
|
|
3
|
-
Version: 0.2.3
|
|
4
|
-
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).
|
|
5
|
-
Author: Mohan Kumar Indala
|
|
6
|
-
License-Expression: MIT
|
|
7
|
-
License-File: LICENSE
|
|
8
|
-
Keywords: ai,claude,excel,llm,mcp,stdio,typescript,windows,word,workspace-explorer
|
|
9
|
-
Classifier: Development Status :: 4 - Beta
|
|
10
|
-
Classifier: Environment :: Win32 (MS Windows)
|
|
11
|
-
Classifier: Intended Audience :: Developers
|
|
12
|
-
Classifier: License :: OSI Approved :: MIT License
|
|
13
|
-
Classifier: Operating System :: Microsoft :: Windows
|
|
14
|
-
Classifier: Programming Language :: Python :: 3
|
|
15
|
-
Classifier: Programming Language :: Python :: 3.10
|
|
16
|
-
Classifier: Programming Language :: Python :: 3.11
|
|
17
|
-
Classifier: Programming Language :: Python :: 3.12
|
|
18
|
-
Classifier: Programming Language :: Python :: 3.13
|
|
19
|
-
Classifier: Programming Language :: Python :: 3.14
|
|
20
|
-
Classifier: Topic :: Software Development :: Libraries
|
|
21
|
-
Requires-Python: >=3.10
|
|
22
|
-
Requires-Dist: mcp>=1.2.0
|
|
23
|
-
Provides-Extra: all
|
|
24
|
-
Requires-Dist: mcp-win-stdio-db>=0.2.3; extra == 'all'
|
|
25
|
-
Requires-Dist: mcp-win-stdio-excel>=0.2.3; extra == 'all'
|
|
26
|
-
Requires-Dist: mcp-win-stdio-explorer>=0.2.3; extra == 'all'
|
|
27
|
-
Requires-Dist: mcp-win-stdio-git>=0.2.3; extra == 'all'
|
|
28
|
-
Requires-Dist: mcp-win-stdio-tsc>=0.2.3; extra == 'all'
|
|
29
|
-
Requires-Dist: mcp-win-stdio-word>=0.2.3; extra == 'all'
|
|
30
|
-
Provides-Extra: db
|
|
31
|
-
Requires-Dist: mcp-win-stdio-db>=0.2.3; extra == 'db'
|
|
32
|
-
Provides-Extra: excel
|
|
33
|
-
Requires-Dist: mcp-win-stdio-excel>=0.2.3; extra == 'excel'
|
|
34
|
-
Provides-Extra: explorer
|
|
35
|
-
Requires-Dist: mcp-win-stdio-explorer>=0.2.3; extra == 'explorer'
|
|
36
|
-
Provides-Extra: git
|
|
37
|
-
Requires-Dist: mcp-win-stdio-git>=0.2.3; extra == 'git'
|
|
38
|
-
Provides-Extra: tsc
|
|
39
|
-
Requires-Dist: mcp-win-stdio-tsc>=0.2.3; extra == 'tsc'
|
|
40
|
-
Provides-Extra: word
|
|
41
|
-
Requires-Dist: mcp-win-stdio-word>=0.2.3; extra == 'word'
|
|
42
|
-
Description-Content-Type: text/markdown
|
|
43
|
-
|
|
44
1
|
# mcp-win-stdio
|
|
45
2
|
|
|
46
3
|
Windows-optimized **Model Context Protocol (MCP)** suite and interactive CLI hub (`mws`) for local `stdio` execution with transparent Claude Desktop & Claude Code CLI configuration.
|
|
@@ -51,13 +8,14 @@ Windows-optimized **Model Context Protocol (MCP)** suite and interactive CLI hub
|
|
|
51
8
|
|
|
52
9
|
---
|
|
53
10
|
|
|
54
|
-
## 🌟 Highlights (
|
|
11
|
+
## 🌟 Highlights (130 Tools Across 7 Modular Servers)
|
|
55
12
|
|
|
56
13
|
* **Interactive CLI Hub (`mws`)**: Run `mws` alone to view all servers, live installation status (`[Installed]` vs `[Not Installed]`), and quick commands.
|
|
57
14
|
* **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).
|
|
58
|
-
* **Dynamic Guide Merging (`mws guide [server]`)**: View comprehensive tool schemas, prompt recipes, and diagnostic checks for individual servers (`mws git guide`, `mws db guide`) or all installed servers merged (`mws guide all`).
|
|
59
|
-
* **
|
|
60
|
-
* **
|
|
15
|
+
* **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`).
|
|
16
|
+
* **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.
|
|
17
|
+
* **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.
|
|
18
|
+
* **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.
|
|
61
19
|
* **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).
|
|
62
20
|
* **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.
|
|
63
21
|
* **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.
|
|
@@ -72,8 +30,9 @@ Each server is published as an independent, lightweight PyPI package. Installing
|
|
|
72
30
|
|
|
73
31
|
| Server | Standalone Package | Tools | Primary Capabilities |
|
|
74
32
|
| :--- | :--- | :---: | :--- |
|
|
75
|
-
| **
|
|
76
|
-
| **
|
|
33
|
+
| **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 |
|
|
34
|
+
| **Git & GitHub** | `pip install mcp-win-stdio-git` | 33 | Local Git init/remotes/restore/bookmarks/branches, commits, diffs + GitHub PR checks, releases, issues, Actions |
|
|
35
|
+
| **Database** | `pip install mcp-win-stdio-db` | 23 | PostgreSQL & MySQL pooling, cross-schema resolution, index audits, schema diffs, DBA management, dump/restore |
|
|
77
36
|
| **Excel** | `pip install mcp-win-stdio-excel` | 20 | Pandas queries, RapidFuzz reconciliation, OpenPyXL, native Excel COM automation |
|
|
78
37
|
| **Word** | `pip install mcp-win-stdio-word` | 10 | Margins (in, cm, mm, pt), multi-column IEEE layout, typography, image extraction |
|
|
79
38
|
| **Explorer** | `pip install mcp-win-stdio-explorer` | 11 | Token-safe tree, .gitignore resolution, in-file grep, AST outlines |
|
|
@@ -81,6 +40,7 @@ Each server is published as an independent, lightweight PyPI package. Installing
|
|
|
81
40
|
|
|
82
41
|
### Install Individual Servers:
|
|
83
42
|
```powershell
|
|
43
|
+
pip install mcp-win-stdio-ssh
|
|
84
44
|
pip install mcp-win-stdio-git
|
|
85
45
|
pip install mcp-win-stdio-db
|
|
86
46
|
pip install mcp-win-stdio-excel
|
|
@@ -112,7 +72,7 @@ mws
|
|
|
112
72
|
Output:
|
|
113
73
|
```text
|
|
114
74
|
============================================================================
|
|
115
|
-
🚀 mcp-win-stdio — Windows Model Context Protocol Suite (v0.2.
|
|
75
|
+
🚀 mcp-win-stdio — Windows Model Context Protocol Suite (v0.2.4)
|
|
116
76
|
============================================================================
|
|
117
77
|
|
|
118
78
|
Single-Source Hub: C:\Users\admin\.mcp-win-stdio
|
|
@@ -151,36 +111,43 @@ mws add db
|
|
|
151
111
|
|
|
152
112
|
| Command | Shorthand / Alternate Syntax | Description |
|
|
153
113
|
| :--- | :--- | :--- |
|
|
154
|
-
| `mws` | `mws list` | Displays interactive terminal home dashboard with server status and tips. |
|
|
114
|
+
| `mws` | `mws list` | Displays interactive terminal home dashboard with live server status, PyPI update alerts, and tips. |
|
|
115
|
+
| `mws install <server\|all>` | `mws <server> install` | Installs standalone server packages from PyPI. |
|
|
116
|
+
| `mws update <server\|all>` | `mws <server> update` | Checks PyPI for new versions and upgrades the suite or specific server. |
|
|
155
117
|
| `mws setup <server>` | `mws add <server>` / `mws <server> setup` | Guides setup, verifies dependencies, and generates Claude config snippets. |
|
|
156
118
|
| `mws remove <server>` | `mws <server> remove` | Safely removes server(s) from Claude Desktop and CLI configs. |
|
|
119
|
+
| `mws uninstall <server\|all>` | `mws <server> uninstall` | Cleanly uninstalls packages and removes Claude registrations while preserving your single-source hub (`~/.mcp-win-stdio`). |
|
|
157
120
|
| `mws guide [server]` | `mws <server> guide` | Prints tool reference, parameter schemas, and prompt recipes for Claude. |
|
|
158
|
-
| `mws doctor` | `mws <server> doctor` | Runs diagnostic health checks (Python, Git CLI, GitHub CLI, COM, DB drivers). |
|
|
121
|
+
| `mws doctor` | `mws <server> doctor` | Runs diagnostic health checks (Python, Git CLI, GitHub CLI, COM, DB drivers, PyPI updates). |
|
|
122
|
+
| `mws fix-path` | `mws path` | Checks and configures Python Scripts/bin directories in Windows User PATH. |
|
|
159
123
|
| `mws run <server>` | `mws <server> run` | Launches the MCP server over stdio. |
|
|
160
124
|
|
|
125
|
+
|
|
161
126
|
> [!TIP]
|
|
162
127
|
> If `mws` is not yet in Windows `PATH`, all commands can be executed using Python's module runner:
|
|
163
128
|
> ```powershell
|
|
164
129
|
> python -m mcp_win_stdio run git
|
|
165
|
-
> python -m mcp_win_stdio
|
|
130
|
+
> python -m mcp_win_stdio update all
|
|
166
131
|
> python -m mcp_win_stdio doctor
|
|
167
132
|
> ```
|
|
168
133
|
|
|
134
|
+
|
|
169
135
|
---
|
|
170
136
|
|
|
171
|
-
## 🛠️ The 6 MCP Servers (
|
|
137
|
+
## 🛠️ The 6 MCP Servers (103 Tools)
|
|
172
138
|
|
|
173
|
-
### 🐙 1. Git & GitHub MCP (`mcp_win_stdio.git`) —
|
|
174
|
-
* **Local Git Suite (
|
|
175
|
-
* **Remote GitHub CLI Suite (
|
|
176
|
-
* **Hybrid Synergy Workflows (
|
|
139
|
+
### 🐙 1. Git & GitHub MCP (`mcp_win_stdio.git`) — 33 Tools
|
|
140
|
+
* **Local Git Suite (20 Tools)**: `git_init`, `git_remote`, `git_restore`, `use_repo`, `list_repos`, `add_repo`, `remove_repo`, `rename_alias`, `git_status`, `git_diff` (with offset pagination), `git_log`, `git_commit` (with untracked safeguards), `git_branch`, `git_stash`, `git_sync`, `git_blame`, `git_reset`, `git_tag`, `git_grep`, `git_worktree`, `git_config`, `git_conflict_resolve`, `git_cherry_pick`, `git_clean_untracked`.
|
|
141
|
+
* **Remote GitHub CLI Suite (10 Tools)**: `gh_auth_status`, `gh_switch_account`, `gh_pr_list`, `gh_pr_view`, `gh_pr_diff`, `gh_pr_checkout`, `gh_pr_action`, `gh_pr_checks`, `gh_pr_review_comments`, `gh_release_list`, `gh_release_create`, `gh_issue_list`, `gh_issue_view`, `gh_issue_create`, `gh_issue_comment`, `gh_run_status`, `gh_gist_create`, `gh_search`, `gh_api`.
|
|
142
|
+
* **Hybrid Synergy Workflows (3 Tools)**:
|
|
143
|
+
* `repo_overview`: 360-degree status combining local branch, dirty status, ahead/behind tracking, active open PR, and latest GitHub Actions workflow run.
|
|
177
144
|
* `pr_quickstart`: Stage $\rightarrow$ Commit $\rightarrow$ Push $\rightarrow$ Create PR via `gh pr create` in one turn.
|
|
178
145
|
* `issue_start_work`: Fetches issue from GitHub and creates a linked local branch `feature/<id>-<slug>`.
|
|
179
146
|
|
|
180
|
-
### 🗄️ 2. Polyglot Database MCP (`mcp_win_stdio.db`) —
|
|
181
|
-
* **Inspection & Resolution**: `list_connections`, `use_database`, `list_databases`, `list_schemas`, `describe_table` (auto cross-schema lookup), `schema_overview`, `get_table_sample`, `search_schema`.
|
|
182
|
-
* **Execution &
|
|
183
|
-
* **DBA Management**: `create_database`, `drop_database` (safety confirmation required), `clone_database` (instant PostgreSQL TEMPLATE clone), `terminate_connections`, `list_active_queries`.
|
|
147
|
+
### 🗄️ 2. Polyglot Database MCP (`mcp_win_stdio.db`) — 23 Tools
|
|
148
|
+
* **Inspection & Resolution**: `list_connections`, `use_database`, `list_databases`, `list_schemas`, `describe_table` (auto cross-schema lookup), `get_table_ddl`, `schema_overview`, `compact_schema_overview`, `get_table_sample`, `search_schema`.
|
|
149
|
+
* **Execution & Diagnostics**: `read_query` (safe SELECT with row counts), `execute_query` (DML/DDL transactions), `explain_query` (EXPLAIN plans), `get_database_stats`, `analyze_table_indexes`, `compare_schemas` (structural diff with migration SQL), `audit_database_health` (unindexed FKs, bloated tables).
|
|
150
|
+
* **DBA Management**: `add_connection`, `create_database`, `drop_database` (safety confirmation required), `clone_database` (instant PostgreSQL TEMPLATE clone), `terminate_connections`, `list_active_queries`.
|
|
184
151
|
* **Native Utilities**: `dump_database` (`pg_dump`/`mysqldump`), `restore_database` (`psql`/`mysql`).
|
|
185
152
|
|
|
186
153
|
### 📊 3. Excel MCP (`mcp_win_stdio.excel`) — 20 Tools
|
|
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
|
|
|
4
4
|
|
|
5
5
|
[project]
|
|
6
6
|
name = "mcp-win-stdio-db"
|
|
7
|
-
version = "0.2.
|
|
7
|
+
version = "0.2.4"
|
|
8
8
|
description = "Unified Database Model Context Protocol (MCP) server for PostgreSQL & MySQL: 20 tools for multi-server querying, DBA operations (create, drop, clone, dump, terminate), and cross-schema auto-resolution."
|
|
9
9
|
readme = "README.md"
|
|
10
10
|
requires-python = ">=3.10"
|
|
@@ -29,7 +29,7 @@ classifiers = [
|
|
|
29
29
|
]
|
|
30
30
|
|
|
31
31
|
dependencies = [
|
|
32
|
-
"mcp-win-stdio>=0.2.
|
|
32
|
+
"mcp-win-stdio>=0.2.4",
|
|
33
33
|
"mcp>=1.2.0",
|
|
34
34
|
"psycopg2-binary>=2.9.0",
|
|
35
35
|
"pymysql>=1.1.0",
|
{mcp_win_stdio-0.2.3 → mcp_win_stdio-0.2.4}/packages/mcp-win-stdio-db/src/mcp_win_stdio/db/guide.py
RENAMED
|
@@ -45,12 +45,12 @@ SCHEMA INSPECTION
|
|
|
45
45
|
- Compact overview of all user tables and views.
|
|
46
46
|
- Args: schemaName (optional str)
|
|
47
47
|
|
|
48
|
-
8. compact_schema_overview [NEW v0.2.
|
|
48
|
+
8. compact_schema_overview [NEW v0.2.4]
|
|
49
49
|
- Ultra-compact one-liner per table: schema.table (col: type PK, col2: FK->ref)
|
|
50
50
|
- Ideal for large databases — fits entire schema in minimal tokens.
|
|
51
51
|
- Args: schemaName (optional str), connection (optional str)
|
|
52
52
|
|
|
53
|
-
9. get_table_ddl [NEW v0.2.
|
|
53
|
+
9. get_table_ddl [NEW v0.2.4]
|
|
54
54
|
- Reconstructs the full CREATE TABLE DDL with column types, NOT NULL,
|
|
55
55
|
defaults, all constraints (PK, FK, UNIQUE, CHECK), and extra indexes.
|
|
56
56
|
- PostgreSQL only (MySQL falls back to SHOW CREATE TABLE).
|
|
@@ -61,7 +61,7 @@ SCHEMA INSPECTION
|
|
|
61
61
|
- Args: query (str)
|
|
62
62
|
|
|
63
63
|
DATA ACCESS
|
|
64
|
-
11. get_table_sample [NEW v0.2.
|
|
64
|
+
11. get_table_sample [NEW v0.2.4]
|
|
65
65
|
- Returns sample rows (default: 5) and estimated row count for quick inspection.
|
|
66
66
|
- mask_sensitive=True (default) auto-redacts PII columns (password, token,
|
|
67
67
|
secret, ssn, api_key, credit_card, etc.) as [REDACTED_SENSITIVE].
|
|
@@ -88,7 +88,7 @@ DIAGNOSTICS & HEALTH
|
|
|
88
88
|
16. list_active_queries
|
|
89
89
|
- Lists running queries, connection duration, and process IDs.
|
|
90
90
|
|
|
91
|
-
17. audit_database_health [NEW v0.2.
|
|
91
|
+
17. audit_database_health [NEW v0.2.4]
|
|
92
92
|
- Database-wide health audit (PostgreSQL only). Returns three categories:
|
|
93
93
|
• unindexed_foreign_keys: FK columns lacking a supporting index (slow JOINs).
|
|
94
94
|
• unused_indexes: Indexes with zero scans — candidates for DROP.
|
|
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
|
|
|
4
4
|
|
|
5
5
|
[project]
|
|
6
6
|
name = "mcp-win-stdio-excel"
|
|
7
|
-
version = "0.2.
|
|
7
|
+
version = "0.2.4"
|
|
8
8
|
description = "Windows-optimized Model Context Protocol (MCP) server for Excel: 20 tools for Pandas queries, RapidFuzz reconciliation, cell editing, and native Excel COM automation (PDF export, recalc, pivots, macros)."
|
|
9
9
|
readme = "README.md"
|
|
10
10
|
requires-python = ">=3.10"
|
|
@@ -29,7 +29,7 @@ classifiers = [
|
|
|
29
29
|
]
|
|
30
30
|
|
|
31
31
|
dependencies = [
|
|
32
|
-
"mcp-win-stdio>=0.2.
|
|
32
|
+
"mcp-win-stdio>=0.2.4",
|
|
33
33
|
"mcp>=1.2.0",
|
|
34
34
|
"pandas>=2.0.0",
|
|
35
35
|
"openpyxl>=3.1.0",
|
|
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
|
|
|
4
4
|
|
|
5
5
|
[project]
|
|
6
6
|
name = "mcp-win-stdio-explorer"
|
|
7
|
-
version = "0.2.
|
|
7
|
+
version = "0.2.4"
|
|
8
8
|
description = "Lightweight Model Context Protocol (MCP) server for token-safe workspace exploration: collapsible directory trees, dynamic .gitignore resolution, in-file grep, RapidFuzz fuzzy search, and AST code outline."
|
|
9
9
|
readme = "README.md"
|
|
10
10
|
requires-python = ">=3.10"
|
|
@@ -29,7 +29,7 @@ classifiers = [
|
|
|
29
29
|
]
|
|
30
30
|
|
|
31
31
|
dependencies = [
|
|
32
|
-
"mcp-win-stdio>=0.2.
|
|
32
|
+
"mcp-win-stdio>=0.2.4",
|
|
33
33
|
"mcp>=1.2.0",
|
|
34
34
|
"pathspec>=0.12.0",
|
|
35
35
|
"rapidfuzz>=3.0.0",
|
|
@@ -1,32 +1,36 @@
|
|
|
1
1
|
# mcp-win-stdio-git
|
|
2
2
|
|
|
3
|
-
Unified Git & GitHub Model Context Protocol (MCP) server for Windows & Claude Desktop: **
|
|
3
|
+
Unified Git & GitHub Model Context Protocol (MCP) server for Windows & Claude Desktop: **33 tools** seamlessly unifying local Git repository management and remote GitHub CLI (`gh`) operations with hybrid synergy workflows.
|
|
4
4
|
|
|
5
5
|
Part of the **`mcp-win-stdio`** Windows-optimized suite.
|
|
6
6
|
|
|
7
7
|
---
|
|
8
8
|
|
|
9
|
-
## 🚀 Features (
|
|
9
|
+
## 🚀 Features (33 Tools)
|
|
10
10
|
|
|
11
|
-
- **Local Git Suite (
|
|
12
|
-
-
|
|
13
|
-
-
|
|
11
|
+
- **Local Git Suite (20 Tools)**:
|
|
12
|
+
- Repository initialization (`git_init`) and bookmark management (`use_repo`, `list_repos`, `add_repo`, `remove_repo`, `rename_alias`).
|
|
13
|
+
- Remotes management (`git_remote`: list, add, set-url, remove, get-url).
|
|
14
|
+
- Safe file restoration (`git_restore`) and guarded destructive reset (`git_reset`).
|
|
15
|
+
- Branching (`git_branch`), staging & commits with untracked safeguards (`git_commit`), paginated chunked diffs (`git_diff`), commit logs (`git_log`), stashing (`git_stash`), remote sync (`git_sync`), blame (`git_blame`), tags (`git_tag`), cherry-pick (`git_cherry_pick`), clean (`git_clean_untracked`), regex search (`git_grep`), and config (`git_config`).
|
|
14
16
|
- Isolated background workspaces via `git_worktree`.
|
|
15
17
|
- In-progress merge and rebase conflict detection & resolution (`git_conflict_resolve`).
|
|
16
|
-
|
|
17
|
-
-
|
|
18
|
-
-
|
|
19
|
-
- Issue tracking (`gh_issue_list`).
|
|
18
|
+
- **Remote GitHub CLI Suite (10 Tools)**:
|
|
19
|
+
- Pull requests (`gh_pr_list`, `gh_pr_view`, `gh_pr_diff`, `gh_pr_checkout`, `gh_pr_action`, `gh_pr_checks`, `gh_pr_review_comments`).
|
|
20
|
+
- Releases (`gh_release_list`, `gh_release_create`).
|
|
21
|
+
- Issue tracking (`gh_issue_list`, `gh_issue_view`, `gh_issue_create`, `gh_issue_comment`).
|
|
20
22
|
- CI/CD workflow monitoring (`gh_run_status`).
|
|
23
|
+
- Global search (`gh_search`) and direct API caller (`gh_api`).
|
|
21
24
|
- Gist snippet creation (`gh_gist_create`).
|
|
22
25
|
- Multi-account awareness and switching (`gh_auth_status`, `gh_switch_account`).
|
|
23
|
-
- **Hybrid Synergy Workflows (
|
|
26
|
+
- **Hybrid Synergy Workflows (3 Tools)**:
|
|
24
27
|
- `repo_overview`: 360-degree status combining local branch, dirty status, ahead/behind tracking, active open PR, and latest GitHub Actions workflow run.
|
|
25
28
|
- `pr_quickstart`: Stage -> commit -> push -> open GitHub PR via `gh pr create` in a single tool call.
|
|
26
29
|
- `issue_start_work`: Fetches GitHub issue details and automatically checks out a linked feature branch `feature/<id>-<slug>`.
|
|
27
30
|
- **Zero-Friction Fallback**:
|
|
28
31
|
- Works 100% locally if GitHub CLI is not installed or unauthenticated, and provides copy-pasteable `winget` commands to install.
|
|
29
32
|
|
|
33
|
+
|
|
30
34
|
---
|
|
31
35
|
|
|
32
36
|
## 📋 Prerequisites & Setup
|