VSCode Context MCP

VSCode Context MCP

一个 MCP（Model Context Protocol）服务，为 AI 助手提供 VSCode 上下文和文件系统操作功能。

概述

VSCode Context MCP 在 AI 助手与您的 VSCode 环境之间建立桥梁，让 AI 模型能够：

1. 访问当前 VSCode 上下文（活动文件、标签页、终端输出）
2. 执行受控的文件系统操作
3. 在受控环境中执行 Shell 命令

这样，AI 助手就能为软件开发任务提供更相关且能结合上下文的帮助。

功能

VSCode 上下文访问

• 获取当前项目路径
• 获取活动文件内容和元数据
• 列出已打开的编辑器标签页
• 访问诊断问题（警告/错误）
• 获取终端输出
• 访问已附加到工作区的文件

文件系统操作

• 读取/写入文件
• 按行编辑文件
• 创建目录
• 列出目录内容
• 生成目录树
• 搜索文件
• 获取文件元数据
• 移动/重命名文件

命令执行

• 运行 Shell 命令并捕获输出
• 受控的执行环境

⚠️ 安全警告

请谨慎选择让此服务运行的命令！ 在 Claude 桌面应用中，请使用 Approve Once（而不是 Allow for This Chat），以便逐条检查命令；如果不信任某条命令，请使用 Deny。权限由运行此服务的用户决定。

此工具尚未实现全面的安全措施，请谨慎使用。

与 AI 助手集成

此 MCP 服务专为兼容 Model Context Protocol 的 AI 助手设计，可增强它们以下方面的能力：

• 理解您的代码上下文
• 提出明智的建议
• 提供相关示例
• 帮助调试问题
• 代表您执行文件操作

1. 安装 VSCode 扩展

注意： 安装前，建议卸载类似的 MCP 服务（例如 filesystem MCP），以避免冲突。

• 从此处下载 VSIX 包
• 打开 VSCode
• 按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）打开命令面板
• 输入 "Extensions: Install from VSIX..." 并选择该项
• 找到下载的 VSIX 文件并选择
• 安装后重启 VSCode

如需了解更多信息，请访问 VSCode 扩展仓库

2. 设置并运行 MCP 服务

首先，克隆或下载此仓库。然后安装依赖项并构建项目：

cd path/to/vscode-context-mcp
npm install
npm run build

构建完成后，更新 Claude Desktop 配置以使用 MCP 服务：

{
  "mcpServers": {
    "vscode-context-mpc": {
      "command": "node",
      "args": [
        "C:\\path\\to\\vscode-context-mcp\\dist\\index.js"
      ]
    }
  }
}

注意： 确保 args 数组中的文件路径与您的实际项目位置一致。

3. 测试连接

若要验证一切是否正常运行，请尝试在 Claude 中使用此提示词：

Please check my current VSCode project and tell me what files I have open.

4. 将文件添加到 Claude 上下文

您可以通过以下几种方式将文件添加到 Claude 上下文：

• 按 Ctrl+L（Windows/Linux）或 Cmd+L（macOS）添加当前文件
• 按 Ctrl+I 或 Cmd+I 仅添加选中的文本
• 打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P），并搜索：
  • "Add File to Context"
  • "Add Selection to Context"

工具参考

工具名称	描述
get_vscode_context	获取完整的 VSCode 上下文信息
get_attached_files	获取附加到工作区的文件列表
get_project_path	获取当前项目根目录
get_current_file	获取当前活动文件的详细信息和内容
get_open_tabs	列出所有打开的编辑器标签页
get_problems	获取诊断信息（错误/警告）
get_terminal_content	获取终端输出和历史记录
run_command	执行 shell 命令
read_file	读取文件内容
read_multiple_files	一次读取多个文件
write_file	创建或覆盖文件
edit_file	按行编辑文件
create_directory	创建目录结构
list_directory	列出文件和目录
directory_tree	获取递归目录结构
move_file	移动或重命名文件和目录
search_files	查找匹配模式的文件
get_file_info	获取详细的文件元数据

路线图

1. 支持多个 VSCode 项目
2. 添加写入或编辑文件时的接受/还原功能
3. 重新设计 UI

贡献

欢迎贡献！欢迎提交 Pull Request。

许可证

本项目采用 MIT License 许可，详情请参阅 LICENSE 文件。