STARWARCLOUD STARWAR.AI
返回市场
vscode-mcp

vscode-mcp

作者：tjx66647 星标更新：2025-11-14
安装使用来源：spider==github.com

项目介绍

VSCode MCP

<p align="center"> <img src="packages/vscode-mcp-bridge/assets/logo.png" alt="VSCode MCP" width="200"/> </p> <p align="center"> <strong>连接VSCode与MCP（模型上下文协议），以增强AI助手的功能</strong> </p> <p align="center"> <a href="#设计动机">设计动机</a> • <a href="#可用工具">可用工具</a> • <a href="#安装">安装</a> • <a href="#架构">架构</a> • <a href="#许可证">许可证</a> </p>

MCP徽章 CI 欢迎PR GitHub开放问题 许可证

概述

VSCode MCP是一个全面的单仓库解决方案，使MCP（模型上下文协议）客户端能够实时访问丰富的VSCode上下文信息。该项目弥合了AI助手与您的开发环境之间的差距，提供准确的代码分析、诊断和智能代码导航。

设计动机

VSCode MCP Bridge主要服务于AI IDE（如Cursor）和AI编码代理，帮助它们更高效地开发和分析代码。

传统的AI编码代理在验证代码修改时通常需要执行耗时的命令：

  • tsc --noEmit - TypeScript类型检查
  • eslint . - 代码风格检查
  • npm run build - 项目构建

这些命令在大型项目中运行缓慢，严重影响AI开发效率。VSCode MCP Bridge提供了实时LSP（语言服务器协议）信息，允许AI代理：

  • 快速诊断 (get-diagnostics) - 替换耗时的类型检查和lint命令
  • 访问全面的LSP信息 (get-symbol-lsp-info) - 在一次调用中获取定义、悬停、签名和类型信息
  • 高效导航代码 (get-references) - 通过使用上下文理解代码结构和依赖关系
  • 安全文件操作 - 跨文件重命名符号并自动更新导入

核心优势

  1. 实时性：利用VSCode的LSP实现实时代码状态，无需执行慢速命令
  2. 准确性：基于语言服务器的精确分析，比静态分析更可靠
  3. 效率：显著减少AI编码代理的等待时间
  4. 集成：深度集成到VSCode生态系统，支持多种语言和扩展

可用工具

VSCode MCP通过MCP协议提供了以下工具：

工具描述
execute_command⚠️ 使用JSON字符串参数执行VSCode命令
get_symbol_lsp_info获取全面的LSP信息（定义、悬停、签名等）
get_diagnostics获取实时诊断，替换慢速的tsc/eslint
get_references查找带有使用上下文代码的符号引用
health_check测试与VSCode MCP Bridge扩展的连接
list_workspaces列出所有可用的VSCode工作区
open_files打开多个文件，可选编辑器显示
rename_symbol在工作区内跨文件重命名符号

⚠️ 安全警告：execute_command工具可以执行任意VSCode命令，并可能触发危险操作。仅使用受信任的AI模型，并谨慎使用。

安装

🚨 重要：在安装MCP服务器之前，您必须首先在VSCode实例中安装VSCode MCP Bridge扩展。该扩展是MCP服务器与VSCode通信所必需的。

第一步：安装VSCode扩展

使用ID YuTengjing.vscode-mcp-bridge 安装VSCode MCP Bridge扩展

安装VSCode扩展

或在VSCode扩展市场搜索“VSCode MCP Bridge”。

第二步：安装MCP服务器

Codex

在您的 ~/.codex/config.toml 中添加以下配置：

[mcp_servers.vscode-mcp]
command = "bunx"
args = ["-y", "@vscode-mcp/vscode-mcp-server@latest"]
env = { "VSCODE_MCP_DISABLED_TOOLS" = "health_check,list_workspaces,open_files" }
startup_timeout_ms = 16_00

Claude Code

Claude Code (claude.ai/code) 提供内置的MCP支持。只需运行：

claude mcp add vscode-mcp -- npx -y @vscode-mcp/vscode-mcp-server@latest

此命令将自动在您的Claude Code环境中配置MCP服务器。

Cursor

单击按钮进行安装

安装MCP服务器

或手动安装

前往 Cursor设置 -> 工具与集成 -> 新MCP服务器。按喜好命名，使用command类型，命令为 npx @vscode-mcp/vscode-mcp-server@latest。您也可以通过点击编辑来验证配置或添加命令行参数。

{
  "mcpServers": {
    "vscode-mcp": {
      "command": "npx",
      "args": ["@vscode-mcp/vscode-mcp-server@latest"]
    }
  }
}

Gemini CLI

在您的 ~/.gemini/settings.json 中添加以下配置：

{
  "mcpServers": {
    "vscode-mcp": {
      "command": "npx",
      "args": ["-y", "@vscode-mcp/vscode-mcp-server@latest"],
      "env": {},
      "includeTools": [
        "get_symbol_lsp_info",
        "get_diagnostics",
        "get_references",
        "health_check",
        "rename_symbol"
      ]
    }
  }
}

工具过滤

您可以使用命令行参数或环境变量控制哪些工具可用：

命令行参数：

  • --enable-tools - 启用的工具的逗号分隔列表（白名单模式）。如果指定了，只有这些工具可用。
  • --disable-tools - 禁用的工具的逗号分隔列表（黑名单模式）。在--enable-tools之后应用。

环境变量：

  • VSCODE_MCP_ENABLED_TOOLS - 与--enable-tools相同
  • VSCODE_MCP_DISABLED_TOOLS - 与--disable-tools相同

架构

一旦安装和配置完成，VSCode MCP将无缝地与兼容MCP的客户端一起工作：

  1. VSCode扩展：在您的VSCode实例中运行，并提供对LSP数据的访问
  2. MCP服务器：将MCP协议调用转换为VSCode扩展请求

所有工具都需要workspace_path参数来定位特定的VSCode实例。每个VSCode工作区都有自己的套接字连接，以支持多窗口。

许可证

本项目根据Anti 996许可证授权。