# WindowsMCP.Net

**Repository Path**: luckythc/windows-mcp.-net

## Basic Information

- **Project Name**: WindowsMCP.Net
- **Description**: WindowsMCP.Net的本地部署测试项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-16
- **Last Updated**: 2025-12-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WindowsMCP.Net 安装使用说明

> 注意：需要结合AI模型进行自然语言的解析
> 本文件测试环境为Windows 11，AI模型为deepseek模型，Python 3.12.12

## 安装

### .Net 10 依赖

```cmd
winget install Microsoft.DotNet.SDK.10
```

### Windows-MCP.Net

```cmd
dotnet tool install --global WindowsMCP.Net
rem 查询是否安装成功
dotnet tool list --global
```

## 使用

### 启动 Windows-MCP.Net（可选）

> 上面安装属于windows全局服务，使用时无需手动启动，直接连接服务即可
> 此处命令行启动仅用于测试服务是否正常，后续使用时无需手动启动

```cmd
WindowsMCP.Net
```

### 连接 Windows-MCP.Net 服务

#### 命令行交互连接测试（可选）

> 此处使用 @modelcontextprotocol/inspector 工具连接 Windows-MCP.Net 服务
> 连接成功后会自动打开浏览器界面

```cmd
npx @modelcontextprotocol/inspector
```

#### 代码连接

> 需配合AI模型进行自然语言的解析，对解析结果进行格式化为WindowsMCP.Net支持的指令格式，再发送给WindowsMCP.Net服务执行

```STEP
1. 接收自然语言指令
2. 连接AI模型，设置系统提示词，发送指令
3. 接收模型返回的指令，解析为WindowsMCP.Net支持的指令格式
4. 发送指令给WindowsMCP.Net服务执行
```

| 文件名               | 说明                                       |
|----------------------|--------------------------------------------|
| final_mcp_client.py  | 简单网页界面示例，连接deepseek模型解析自然语言 |
| simple_stdio_client.py | 部分指令交互示例                           |

### 测试记录

1. 结合系统提示，AI模型可以返回准确的指令，包括多步骤的指令数组
2. 执行前后衔接的指令会存在问题，比如先截屏为文件再打开，截屏的文件没有传递到下一个步骤（可能是测试代码的逻辑存在问题）
3. 图片识别相关的指令会导致WindowsMCP.Net服务自动下载ocr模型，但有可能下载失败（因为墙）
4. 未找到打开文件指令，如打开图片，此时会调用浏览器而不是关联的图片浏览程序，且无法使用浏览器打开本地文件
5. ‘播放图片文件夹里的图片’指令deepseek返回无法识别
6. "打开xxx"的指令微信、Foxmail、迅雷均失败，wps、浏览器成功，暂不清楚什么原因