juehang

@juehang/vscode-mcp-server

0 Stars 328 次浏览 juehang 更新于 2026-08-23

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "vscode-mcp-server": {
      "args": [
        "mcp-remote@next",
        "http://localhost:3000/mcp"
      ],
      "command": "npx"
    }
  }
}

服务介绍

VS Code MCP 服务器

这是一个 Visual Studio Code 扩展（可在 Marketplace 上获取），它允许 Claude 和其他 MCP 客户端直接在 VS Code 中进行编码！该扩展受到了 Serena 的启发，但使用了 VS Code 内置的功能。目前这个扩展比 Serena 简单得多，但它确实有效！请注意，此扩展使用的是可流式传输的 HTTP API，而不是 SSE API。

此扩展可以执行 shell 命令。这意味着存在潜在的安全风险，因此请谨慎使用，并确保您信任正在使用的 MCP 客户端，并且端口没有暴露给任何外部环境。身份验证会有帮助，但由于 MCP 身份验证规范仍在变动中，目前尚未实现这一功能。

欢迎提交 PR！

演示视频

https://github.com/user-attachments/assets/20b87dfb-fc39-4710-a910-b9481dde1e90

安装

从 Marketplace 安装扩展，或者克隆此仓库并运行 npm install 和 npm run compile 来构建它。

Claude Desktop 配置

可以配置 Claude Desktop 使用此扩展作为 MCP 服务器。为此，您的 claude_desktop_config.json 文件应如下所示：

{
"mcpServers": {
"vscode-mcp-server": {
"command": "npx",
"args": ["mcp-remote@next", "http://localhost:3000/mcp"]
}

}
}

我还喜欢在一个 Claude 项目中使用此扩展，因为它允许我为 Claude 指定额外的指令。我发现以下提示效果很好：

你正在处理一个现有的代码库，你可以通过你的工具访问它。这些代码工具与 VS Code 工作区交互。

在运行任何会修改代码的代码工具之前，始终向用户呈现一个全面而详细的计划，包括你的信心水平（满分10分）。在规划时，使用你的工具来探索代码库，以便理解项目的上下文。如果你因为需要更多信息而不自信，请使用你的工具（如网络搜索）查找这些信息或询问用户。

重要：只有在向用户呈现这样的计划并获得明确批准后，才能运行会修改代码的代码工具。每次更改都必须单独获得批准；之前的批准并不意味着后续更改也已获批准。

此扩展充当 Model Context Protocol (MCP) 服务器，将 VS Code 的文件系统和编辑功能暴露给 MCP 客户端。

功能

VS Code MCP 服务器扩展实现了一个符合 MCP 标准的服务器，允许 AI 模型和其他 MCP 客户端：

列出文件和目录 在您的 VS Code 工作区中
读取文件内容 支持编码和大小限制
在工作区中搜索符号
获取符号定义 和悬停信息，按行和符号名称
使用 VS Code 的 WorkspaceEdit API 创建新文件
在文件中进行行替换
检查工作区中的诊断（错误和警告）
在集成终端中执行 shell 命令，支持 shell 集成
通过状态栏项切换服务器 开关

此扩展使 AI 助手和其他工具能够通过标准化的 MCP 协议与您的 VS Code 工作区进行交互。

工作原理

该扩展创建了一个 MCP 服务器，该服务器：

在本地可配置的端口上运行（启用时）
通过 HTTP 处理 MCP 协议请求
将 VS Code 的功能作为 MCP 工具暴露出来
提供一个状态栏指示器显示服务器状态，可以通过点击来切换服务器的开关

支持的 MCP 工具

文件工具

list_files_code: 列出工作区中的文件和目录
- 参数：
  - path: 要列出文件的路径
  - recursive（可选）: 是否递归列出文件- read_file_code: 读取文件内容
- 参数：
  - path: 要读取的文件路径
  - encoding (可选): 文件编码（默认: utf-8）
  - maxCharacters (可选): 最大字符数（默认: 100,000）

编辑工具

create_file_code: 使用 VS Code 的 WorkspaceEdit API 创建新文件
- 参数：
  - path: 要创建的文件路径
  - content: 要写入文件的内容
  - overwrite (可选): 如果文件已存在是否覆盖（默认: false）
  - ignoreIfExists (可选): 如果文件已存在是否忽略（默认: false）
replace_lines_code: 替换文件中的特定行
- 参数：
  - path: 要修改的文件路径
  - startLine: 开始行号（基于1，包含）
  - endLine: 结束行号（基于1，包含）
  - content: 用于替换这些行的新内容
  - originalCode: 用于验证的原始代码

诊断工具

get_diagnostics_code: 检查工作区中的警告和错误
- 参数：
  - path (可选): 要检查的文件路径（如果未提供，则检查整个工作区）
  - severities (可选): 要包括的严重性级别数组（0=错误, 1=警告, 2=信息, 3=提示）。默认: [0, 1]
  - format (可选): 输出格式（text 或 json）。默认: text
  - includeSource (可选): 是否包括诊断源。默认: true
此工具特别适用于：
- 在提交更改前进行代码质量检查
- 验证修复是否解决了所有报告的问题
- 识别特定文件或整个工作区中的问题

符号工具

search_symbols_code: 在工作区中搜索符号
- 参数：
  - query: 符号名称的搜索查询
  - maxResults (可选): 返回的最大结果数（默认: 10）
此工具适用于：
- 查找代码库中符号（函数、类、变量等）的定义
- 探索项目结构和组织
- 按名称查找特定元素
get_symbol_definition_code: 获取文件中符号的定义信息
- 参数：
  - path: 包含符号的文件路径
  - line: 符号所在的行号
  - symbol: 要在指定行查找的符号名称
此工具提供：
- 符号的类型信息、文档和源详细信息
- 显示符号出现的代码上下文
- 符号范围信息
它特别适用于：
- 不需要导航即可理解符号代表什么
- 检查函数签名、类型定义或文档
- 快速参考API或库函数

Shell 工具

execute_shell_command_code: 在具有 shell 集成的 VS Code 集成终端中执行 shell 命令
- 参数：
  - command: 要执行的 shell 命令
  - cwd (可选): 命令的工作目录（默认: .）
此工具适用于：
- 运行 CLI 命令和构建操作
- 执行 git 命令
- 执行任何需要终端访问的 shell 操作
- 获取命令输出以进行分析和进一步处理

注意事项/待办事项

目前仅支持一个工作区。此扩展也仅限本地使用，以避免将您的 VS Code 实例暴露于您可能连接到的任何网络。

扩展设置

此扩展贡献了以下设置：

vscode-mcp-server.port: MCP 服务器的端口号（默认: 3000）

与 MCP 客户端一起使用

要将 MCP 客户端与此服务器连接，请配置它们使用：

http://localhost:3000/mcp

请记住，您需要先通过点击状态栏项来启用服务器！

贡献

欢迎贡献！随时提交问题或拉取请求。

许可证

MIT

查看源码项目主页