关键词

AI 助手VSCode 扩展代码编辑调试版本控制MCP 协议

使用说明

项目简介

ggMCP4VSCode 是一款 VSCode 扩展，它在 VSCode 内部集成了一个 Model Context Protocol (MCP) 服务器。这个服务器允许支持 MCP 协议的 AI 助手（如 Claude Desktop）直接访问和操作 VSCode 环境，从而极大地增强了 AI 助手在代码理解、编辑和项目管理方面的能力。

主要功能点

  • 零配置启动: 扩展安装后自动启动 MCP 服务器，无需用户手动配置。
  • 代码感知: AI 助手可以读取、修改和分析当前 VSCode 打开的代码文件。
  • 文件操作: 支持 AI 助手创建、编辑和搜索项目中的文件。
  • 调试集成: 允许 AI 助手辅助管理断点和运行配置，提升调试效率。
  • 终端控制: AI 助手可以执行终端命令并获取输出结果。
  • Git 集成: 支持 AI 助手查询 Git 变更状态和提交历史。

安装步骤

  1. 打开 VSCode 编辑器。
  2. 点击左侧边栏的扩展图标 (方块形状)。
  3. 在搜索框中输入 'ggMCP4VSCode'。
  4. 在搜索结果中找到 'ggMCP4VSCode' 扩展，点击 "安装" 按钮。
  5. 安装完成后，重启 VSCode (如果提示)。

服务器配置

MCP 服务器在 VSCode 扩展中自动运行，无需手动启动。对于 MCP 客户端（如 MCPxHub 插件），您需要配置以下连接信息以连接到 VSCode MCP Server：

{
  "serverName": "VSCode MCP Server",
  "command": "vscode",
  "args": [],
  "port": 自动检测或在 VSCode 设置中配置的端口范围
}
  • 'serverName': MCP 服务器的名称，可以自定义，例如 "VSCode MCP Server"。
  • 'command': 设置为 '"vscode"'，表示这是一个 VSCode 扩展提供的 MCP 服务器（实际上客户端无需直接执行命令，扩展已在 VSCode 内部运行）。
  • 'args': 启动参数，对于 VSCode 扩展的 MCP 服务器，通常无需参数，设置为空数组 '[]' 即可。
  • 'port': 端口号，VSCode MCP Server 会自动在 '9960-9990' 端口范围内查找可用端口。您也可以在 VSCode 设置中搜索 'ggMCP' 来自定义端口范围。MCP 客户端需要能够自动检测或配置为连接到这个端口。

基本使用方法

  1. 安装并启用 'ggMCP4VSCode' 扩展后，MCP 服务器会在 VSCode 后台自动运行。您可以在 VSCode 状态栏右下角看到服务器状态图标：
    • $(sync~spin) VSCode MCP Server - 服务器正在启动
    • $(zap) VSCode MCP Server - 服务器已运行
    • $(error) VSCode MCP Server - 服务器发生错误
  2. 安装并配置支持 MCP 协议的 AI 助手客户端（例如 Claude Desktop 配合 MCPxHub 插件）。
  3. 在 AI 助手客户端中，配置连接到 VSCode MCP Server。客户端应能自动检测或允许您手动输入 VSCode MCP Server 运行的端口。
  4. 现在，您就可以在 AI 助手中使用 MCP 协议提供的功能，例如：
    • 询问 AI 助手查看当前打开的文件
    • 请求 AI 助手修改代码
    • 让 AI 助手执行项目相关的任务，如搜索文件、查看 Git 状态等

更多配置

您可以在 VSCode 的设置中搜索 'ggMCP'，找到扩展的配置选项，例如自定义端口范围、终端超时时间、文件自动重载选项等。

命令

  • 'MCP: Show Server Status': 查看当前服务器状态信息。
  • 'MCP: Restart Server': 手动重启 MCP 服务器。

信息

分类

开发者工具

访问项目