mcp-win-stdio-git 0.2.3__py3-none-any.whl
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/git/__init__.py +5 -0
- mcp_win_stdio/git/__main__.py +8 -0
- mcp_win_stdio/git/cli.py +134 -0
- mcp_win_stdio/git/guide.py +150 -0
- mcp_win_stdio/git/server.py +1899 -0
- mcp_win_stdio_git-0.2.3.dist-info/METADATA +118 -0
- mcp_win_stdio_git-0.2.3.dist-info/RECORD +9 -0
- mcp_win_stdio_git-0.2.3.dist-info/WHEEL +4 -0
- mcp_win_stdio_git-0.2.3.dist-info/entry_points.txt +3 -0
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
Metadata-Version: 2.5
|
|
2
|
+
Name: mcp-win-stdio-git
|
|
3
|
+
Version: 0.2.3
|
|
4
|
+
Summary: Unified Git & GitHub Model Context Protocol (MCP) server for Windows & Claude: 26 tools combining local Git repository management and remote GitHub CLI (gh) operations with hybrid synergy workflows.
|
|
5
|
+
Author: Mohan Kumar Indala
|
|
6
|
+
License-Expression: MIT
|
|
7
|
+
Keywords: actions,ai,claude,gh,git,github,issues,llm,mcp,pull-requests,version-control
|
|
8
|
+
Classifier: Development Status :: 4 - Beta
|
|
9
|
+
Classifier: Environment :: Win32 (MS Windows)
|
|
10
|
+
Classifier: Intended Audience :: Developers
|
|
11
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
12
|
+
Classifier: Operating System :: Microsoft :: Windows
|
|
13
|
+
Classifier: Programming Language :: Python :: 3
|
|
14
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
15
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
16
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.14
|
|
19
|
+
Classifier: Topic :: Software Development :: Version Control :: Git
|
|
20
|
+
Requires-Python: >=3.10
|
|
21
|
+
Requires-Dist: mcp-win-stdio>=0.2.3
|
|
22
|
+
Requires-Dist: mcp>=1.2.0
|
|
23
|
+
Description-Content-Type: text/markdown
|
|
24
|
+
|
|
25
|
+
# mcp-win-stdio-git
|
|
26
|
+
|
|
27
|
+
Unified Git & GitHub Model Context Protocol (MCP) server for Windows & Claude Desktop: **26 tools** seamlessly unifying local Git repository management and remote GitHub CLI (`gh`) operations with hybrid synergy workflows.
|
|
28
|
+
|
|
29
|
+
Part of the **`mcp-win-stdio`** Windows-optimized suite.
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## 🚀 Features (26 Tools)
|
|
34
|
+
|
|
35
|
+
- **Local Git Suite (16 Tools)**:
|
|
36
|
+
- Branching (`git_branch`), staging & commits with identity checks (`git_commit`), token-safe diffs (`git_diff`), commit logs (`git_log`), stashing (`git_stash`), remote sync (`git_sync`), blame (`git_blame`), tags (`git_tag`), regex search (`git_grep`), and config (`git_config`).
|
|
37
|
+
- Safe file restoration and guarded destructive reset (`git_reset`).
|
|
38
|
+
- Isolated background workspaces via `git_worktree`.
|
|
39
|
+
- In-progress merge and rebase conflict detection & resolution (`git_conflict_resolve`).
|
|
40
|
+
- Multi-repo switching and bookmarking (`repo_overview`, `use_repo`, `list_repos`, `add_repo`).
|
|
41
|
+
- **Remote GitHub CLI Suite (8 Tools)**:
|
|
42
|
+
- Pull requests (`gh_pr_list`, `gh_pr_view`, `gh_pr_diff`).
|
|
43
|
+
- Issue tracking (`gh_issue_list`).
|
|
44
|
+
- CI/CD workflow monitoring (`gh_run_status`).
|
|
45
|
+
- Gist snippet creation (`gh_gist_create`).
|
|
46
|
+
- Multi-account awareness and switching (`gh_auth_status`, `gh_switch_account`).
|
|
47
|
+
- **Hybrid Synergy Workflows (2 Tools)**:
|
|
48
|
+
- `repo_overview`: 360-degree status combining local branch, dirty status, ahead/behind tracking, active open PR, and latest GitHub Actions workflow run.
|
|
49
|
+
- `pr_quickstart`: Stage -> commit -> push -> open GitHub PR via `gh pr create` in a single tool call.
|
|
50
|
+
- `issue_start_work`: Fetches GitHub issue details and automatically checks out a linked feature branch `feature/<id>-<slug>`.
|
|
51
|
+
- **Zero-Friction Fallback**:
|
|
52
|
+
- Works 100% locally if GitHub CLI is not installed or unauthenticated, and provides copy-pasteable `winget` commands to install.
|
|
53
|
+
|
|
54
|
+
---
|
|
55
|
+
|
|
56
|
+
## 📋 Prerequisites & Setup
|
|
57
|
+
|
|
58
|
+
1. **Install Git CLI** (if not installed):
|
|
59
|
+
```powershell
|
|
60
|
+
winget install --id Git.Git -e
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
2. **Install GitHub CLI** (recommended for PRs, Issues, Actions):
|
|
64
|
+
```powershell
|
|
65
|
+
winget install --id GitHub.cli -e
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
3. **Authenticate & Setup Git Credential Helper**:
|
|
69
|
+
```powershell
|
|
70
|
+
gh auth login
|
|
71
|
+
gh auth setup-git
|
|
72
|
+
```
|
|
73
|
+
> [!IMPORTANT]
|
|
74
|
+
> `gh auth setup-git` is crucial so your local git push/pull and multi-account switching (`gh_switch_account`) authenticate smoothly.
|
|
75
|
+
|
|
76
|
+
---
|
|
77
|
+
|
|
78
|
+
## 📦 Installation
|
|
79
|
+
|
|
80
|
+
```powershell
|
|
81
|
+
pip install mcp-win-stdio-git
|
|
82
|
+
```
|
|
83
|
+
*(Installing this package automatically installs `mws` CLI orchestrator)*.
|
|
84
|
+
|
|
85
|
+
---
|
|
86
|
+
|
|
87
|
+
## 🚀 One-Command Claude Setup
|
|
88
|
+
|
|
89
|
+
```powershell
|
|
90
|
+
mws setup git
|
|
91
|
+
# or:
|
|
92
|
+
mws add git
|
|
93
|
+
```
|
|
94
|
+
This automatically configures Claude Desktop (`claude_desktop_config.json`) and Claude Code CLI with zero manual JSON editing.
|
|
95
|
+
|
|
96
|
+
### Manual Configuration
|
|
97
|
+
```json
|
|
98
|
+
"git": {
|
|
99
|
+
"command": "python",
|
|
100
|
+
"args": ["-m", "mcp_win_stdio.git"]
|
|
101
|
+
}
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
## 📖 CLI Commands & Interactive Guide
|
|
107
|
+
|
|
108
|
+
```powershell
|
|
109
|
+
mws git guide # Complete tool reference & prompt recipes
|
|
110
|
+
mws git doctor # Verify Git, GitHub CLI, and credential helper status
|
|
111
|
+
mws git setup # Configure Claude Desktop / Claude Code
|
|
112
|
+
mws git run # Launch server over stdio
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
---
|
|
116
|
+
|
|
117
|
+
## 📜 License
|
|
118
|
+
MIT License. Copyright (c) 2026 Mohan Kumar Indala.
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
mcp_win_stdio/git/__init__.py,sha256=e35pL_VIkx3XYOlnIO1KMosv9w81gOAsUiwLaCLNscw,74
|
|
2
|
+
mcp_win_stdio/git/__main__.py,sha256=-J9CfbU5dCQPrUmnj64yv9qqNCkkSrAzxerUHAnckeA,146
|
|
3
|
+
mcp_win_stdio/git/cli.py,sha256=tqNzlXMkAb4cyZeLTddyFIItPI0Vo4Ng_AtcdJhXhiM,5792
|
|
4
|
+
mcp_win_stdio/git/guide.py,sha256=TljDBG62Amm-cVblQ75JxFLodHxlTFlYPynAVsm6kOw,7428
|
|
5
|
+
mcp_win_stdio/git/server.py,sha256=0icSlhcyBvQ5sTA5iZlfh1egUen6P-3-JHWFcT_iyU0,63175
|
|
6
|
+
mcp_win_stdio_git-0.2.3.dist-info/METADATA,sha256=JhUojUrVoJq1J9dPKsWiROCDzOfAiKiMgEZBnuMKGGg,4420
|
|
7
|
+
mcp_win_stdio_git-0.2.3.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
|
|
8
|
+
mcp_win_stdio_git-0.2.3.dist-info/entry_points.txt,sha256=4tZa8AP1-rg3KUS0VwxBoIhFcpJfF1qyApwB-amcilg,102
|
|
9
|
+
mcp_win_stdio_git-0.2.3.dist-info/RECORD,,
|