内容
通用VSMCP（UVM）
## .NET 原生MCP服务器，适用于Visual Studio 2026/2022
**使AI代理能够通过模型上下文协议（MCP）原生控制Visual Studio 2026/2022。**
---
## 安装（单一方法）
### NuGet软件包（推荐）
```bash
dotnet tool install -g UniversalVSMCP
```
运行：
```bash
universal-vsmcp --stdio
```
验证安装：
```bash
universal-vsmcp --help
```
**软件包：** https://www.nuget.org/packages/UniversalVSMCP/
---
## 快速入门
### 1. 启动Visual Studio 2026
打开任意解决方案或创建一个新方案。
### 2. 运行MCP服务器
```bash
universal-vsmcp --stdio
```
### 3. 在VS 2026中配置
前往 **工具 → 选项 → 环境 → 扩展**：
- 添加MCP服务器：`universal-vsmcp`
- 命令：`dotnet tool run --global universal-vsmcp -- --stdio`
---
## 可用工具（共30个）
### 解决方案管理（6）
| 工具 | 描述 |
|------|-------------|
| `_projects` | 获取解决方案中的所有项目 |
| `get_solution_path` | 获取解决方案文件路径 |
| `get_solution_name` | 获取解决方案名称 |
| `open_solution` | 打开.sln文件 |
| `close_solution` | 关闭当前解决方案 |
| `create_solution` | 创建新解决方案（工作区） |
### 项目管理（5）
| 工具 | 描述 |
|------|-------------|
| `get_project_files` | 获取项目中的文件 |
| `get_startup_projects` | 获取启动项目（s） |
| `add_file_to_project` | 将文件添加到项目 |
| `set_startup_project` | 设置启动项目 |
| `get_project_properties` |属性 |
### 文件操作（5）
| 工具 | 描述 |
|------|-------------|
| `open_file` | 在VS编辑器中 |
| `read_file 读取文件内容 |
| `write_file` | 写入文件| `replace_in_file 在文件中替换文本 |
|_file_info` | 获取文件信息 |
### 构建操作（6）
| 工具 | 描述 |
|------|-------------|
| `build_solution` | 构建解决方案 |
| `rebuild_solution` | 重建解决方案 |
| `clean_solution` | 清理解决方案 |
| `build_project` | 构建特定项目 |
| `get_build_errors` | 获取构建错误 |
| `get_build_configurations` | 获取构建配置 |
### 调试控制（8）
| 工具 | 描述 |
|------|-------------|
| `start_debugging` | 启动调试（F5） |
| `stop_debugging` | 停止调试（Shift+F5） |
| `toggle_breakpoint` | 导航到断点行 |
| `continue_execution` | 从断点继续（F5） |
| `step_over` | 单步跳过（F10） |
| `step_into` | 单步进入（F11） |
| `step_out` | 单步退出（Shift+F11） |
| `get_debug_state` | 获取调试状态 |
### 诊断（3）
| 工具 | 描述 |
|------|-------------|
| `health_check` | 验证服务器和VS连接 |
| `get_server_info` | 获取服务器信息 |
| `get_diagnostic_logs` | 获取最近的诊断日志 |
---
## 命令行选项
```bash
universal-vsmcp --stdio # 默认：stdio传输
universal-vsmcp --stdio --log-file uv.log # 启用文件日志记录
universal-vsmcp --verify # 验证VS连接
universal-vsmcp --help # 显示帮助
```
---
## 配置
### VS 2026 配置
**方法A：直接JSON（推荐）**
1往 **工具 → 选项 → 环境 → 扩展**
2. 勾选 **"以JSON编辑用户设置"**
3. 粘贴：
```json
{
"mcpServers": {
"universal-vsmcp": {
"command": "dotnet",
"args": [
"tool",
"run",
"--global",
"universal-v",
"-- "--stdio"
],
"env": {
"VS_AUTO_DETECT": "true"
}
}
}
}
```
**方法B：图形界面**
1. **工具选项 → 环境 → 2. 在 **MCP服务器列表** 中，点击 **3. 填写：
- **名称**：`universal-vsmcp`
- **命令**：`dotnet`
- **参数**：`tool run --global universal-vsmcp -- --stdio`
### Claude 桌面版 / Cursor
```json
{
"mcpServers": {
"vsmcp": {
"command": "dotnet",
"args": ["tool", "run", "--global", "universal-vsmcp", "--", "--stdio"],
"env": {
"VS_AUTO_DETECT": "true"
}
}
}
}
```
---
## 本地主机支持
用于本地开发或SSE传输：
```json
{
"mcpServers": {
"vsmcp-local": {
"command": "dotnet",
"args": [
"run "--project",
"${}",
"--",
"--stdio"
],
"transport": "stdio",
"url": "http://localhost:6277/sse"
}
}
}
```
---
## 故障排除
### 验证连接
```bash
# 检查服务器是否安装
dotnet tool list -g
# 从MCP客户端运行健康检查工具
# 或运行并启用日志记录：
universal-vsmcp --stdio --log-file uv.log
```
### 常见问题
| 问题 | 解决方案 |
|-------|----------|
| "未找到VS实例" | 请先启动Visual Studio |
| "服务器无响应" | 检查 `UVM_LOG_FILE` 中的错误 |
| "工具未找到" | 验证服务器是否正在运行 |
| "连接失败" | 确保VS未以管理员身份运行 |
---
## 要求
- .NET 8.0 SDK 或更高版本
- Visual Studio 2026（18.0）或 VS 2022（17.14+）
- Windows 10 或更高版本
---
## 许可证
MIT © StarsailsClover
---
## 链接
- [NuGet 软件包](https://www.org/packages/UniversalVSMCP/)
- [GitHub](https://github.com/StarsailsClover/UniversalVSMCP)
- [MCP 文档](https://modelcontextprotocol.io/)
- [VS 2026 MCP 指南](https://learn.microsoft.com/visualstudio/ide/mcp-servers)
