WinGet MCP

https://github.com/zhanziyuan/winget-mcp
Admin
WinGet MCP is a Gemini CLI extension that integrates the Windows Package Manager with the Model...
Tokens:2,972
Snippets:36
Trust Score:8.8
Update:3 months ago
Show doc for...
Tokens:
Raw
### WinGet Installation Command Example

Source: https://context7.com/zhanziyuan/winget-mcp/llms.txt

Example of a WinGet installation command generated by the package-manager-expert skill. Always verify the publisher and source before executing.

```powershell
winget install --id Python.Python.3 --source winget
```

```powershell
winget install --id Microsoft.VisualStudioCode --source winget
```

```powershell
winget install --id Git.Git --source winget
```

--------------------------------

### Automated Python Environment Setup Prompt

Source: https://context7.com/zhanziyuan/winget-mcp/llms.txt

Example prompt for setting up a Python development environment. The skill deconstructs the request, verifies package IDs, and generates installation commands.

```plaintext
# Example prompt (English)
"Set up a complete Python development environment for me."

# Skill workflow:
# 1. Deconstruct → [Python, VS Code, Git, pip tooling]
# 2. Verify each:
#    find("Python")  → Python.Python.3
#    find("VS Code") → Microsoft.VisualStudioCode
#    find("Git")     → Git.Git
# 3. Generate plan:
#
# Here is your Python development environment setup plan:
#
# | Package        | ID                         | Version | 
# |----------------|---------------------------|---------|
# | Python 3       | Python.Python.3            | 3.12.4  |
# | Visual Studio Code | Microsoft.VisualStudioCode | 1.90.2 |
# | Git            | Git.Git                    | 2.45.2  |
#
# Installation commands:
# ```powershell
# winget install --id Python.Python.3 --source winget
# winget install --id Microsoft.VisualStudioCode --source winget
# winget install --id Git.Git --source winget
# ```
# ⚠️ Verify Publisher and Source before executing.

# Same request in Chinese
"帮我配置一个完整的 Node.js 开发环境。"
# Skill responds entirely in Chinese, keeping Package IDs and commands in English.

# Lightweight tool recommendation
"I need a lightweight text editor."
# Skill calls find("Notepad++") and find("VS Code"), then presents options with descriptions.
```

--------------------------------

### Install a Package using WinGet MCP

Source: https://github.com/zhanziyuan/winget-mcp/blob/main/README.md

Employ the '/winget:install' command with the package ID to generate installation commands, including safety warnings. Natural language queries for installation are also supported.

```bash
/winget:install "Microsoft.VisualStudioCode"
```

--------------------------------

### Generate WinGet Install Command with /winget:install

Source: https://context7.com/zhanziyuan/winget-mcp/llms.txt

The `/winget:install` command generates the exact `winget install` command for a given Package ID. It includes a mandatory safety warning in the user's language.

```powershell
# Generate install command for a known Package ID
/winget:install "Microsoft.VisualStudioCode"

# Expected output:
# ```powershell
# winget install --id Microsoft.VisualStudioCode --source winget
# ```
# ⚠️ Safety Warning: Before running this command, verify the Publisher
# and Source to ensure you are installing software from a trusted origin.

# Natural-language equivalent
# User: "How do I install Chrome?"
# Gemini resolves the Package ID via find, then generates:
# winget install --id Google.Chrome --source winget
# + safety warning in English

# Chinese request — warning is automatically in Chinese
/winget:install "Google.Chrome"
# ⚠️ 安全提示：执行命令前，请务必核实软件的"发布者"和"来源"。
```

--------------------------------

### Install WinGet MCP Extension via URL

Source: https://github.com/zhanziyuan/winget-mcp/blob/main/README.md

Alternatively, install the extension directly using its GitHub URL with the Gemini CLI. Restart your Gemini CLI session after installation.

```bash
gemini extensions install https://github.com/ZhanZiyuan/winget-mcp
```

--------------------------------

### Manual Setup: Link Local WinGet MCP Clone

Source: https://context7.com/zhanziyuan/winget-mcp/llms.txt

Steps for manually setting up the WinGet MCP extension by cloning the repository and linking it to the Gemini CLI. This involves finding the MCP server path and editing the extension manifest.

```bash
# 1. Discover the path to WindowsPackageManagerMCPServer.exe
winget mcp
# Example output:
# {
#   "mcpServers": {
#     "winget-mcp": {
#       "command": "C:\\Users\\Alice\\AppData\\Local\\Microsoft\\WindowsApps\\...\\WindowsPackageManagerMCPServer.exe"
#     }
#   }
# }

# 2. Clone the repository
git clone https://github.com/ZhanZiyuan/winget-mcp
cd winget-mcp

# 3. Edit gemini-extension.json — replace the placeholder path with the real one
# (see configuration section below)

# 4. Link the extension to Gemini CLI
gemini extensions link .
```

--------------------------------

### Run WinGet MCP Command

Source: https://github.com/zhanziyuan/winget-mcp/blob/main/README.md

Execute the 'winget mcp' command in your terminal to obtain the JSON configuration fragment containing the path to the WindowsPackageManagerMCPServer.exe file. If an error occurs, ensure the App Installer is up to date.

```bash
winget mcp
```

--------------------------------

### WinGet MCP Extension Manifest Configuration

Source: https://context7.com/zhanziyuan/winget-mcp/llms.txt

The `gemini-extension.json` file configures the MCP server for the Gemini CLI. Note that Windows paths require double backslashes.

```json
{
  "name": "winget-mcp",
  "version": "1.0.2",
  "description": "A Gemini CLI extension for the Windows Package Manager (WinGet) MCP server.",
  "contextFileName": "GEMINI.md",
  "mcpServers": {
    "winget-mcp": {
      "type": "stdio",
      "command": "C:\\Users\\Alice\\AppData\\Local\\Microsoft\\WindowsApps\\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\\WindowsPackageManagerMCPServer.exe",
      "args": [],
      "env": {}
    }
  }
}
```

--------------------------------

### Configure WinGet MCP Server in Gemini

Source: https://github.com/zhanziyuan/winget-mcp/blob/main/README.md

Update the 'gemini-extension.json' file by replacing the existing path in the 'mcpServers.winget-mcp.command' field with the path obtained from the 'winget mcp' command. Remember to double the backslashes in the JSON file path.

```json
"mcpServers": {
    "winget-mcp": {
      "type": "stdio",
      "command": "C:\\Users\\<username>\\AppData\\Local\\Microsoft\\WindowsApps\\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\\WindowsPackageManagerMCPServer.exe",
      "args": [],
      "env": {}
    }
  }
```

--------------------------------

### Search WinGet Repository with /winget:find

Source: https://context7.com/zhanziyuan/winget-mcp/llms.txt

Use the `/winget:find` command to search the WinGet package repository. The command supports natural language queries and automatically translates labels to the user's detected language.

```bash
# Search by application name
/winget:find "Visual Studio Code"

# Expected output (English context):
# | Name                     | ID                          | Version | Source  |
# |--------------------------|----------------------------|---------|---------|
# | Visual Studio Code       | Microsoft.VisualStudioCode  | 1.90.2  | winget  |
# | Visual Studio Code - OSS | VSCodium.VSCodium           | 1.90.2  | winget  |

# Search using natural language (no slash command needed)
# User: "Find me a PDF reader."
# Gemini calls find("PDF reader") automatically and returns matching packages.

# Chinese-language search (labels auto-translated)
/winget:find "浏览器"
# Output uses Chinese field labels: 名称 / 版本 / 来源
```

--------------------------------

### Find a Package using WinGet MCP

Source: https://github.com/zhanziyuan/winget-mcp/blob/main/README.md

Use the '/winget:find' command followed by the package name to search for software packages in the WinGet repository. You can also use natural language queries.

```bash
/winget:find "Visual Studio Code"
```

--------------------------------

### Link WinGet MCP Extension to Gemini CLI

Source: https://github.com/zhanziyuan/winget-mcp/blob/main/README.md

After updating the configuration file, link the extension to your Gemini CLI by running the provided command in your terminal. Restart your Gemini CLI session after linking.

```bash
gemini extensions link .
```
Tokens:
Raw