终端管理扩展

一个VS Code扩展,通过MCP服务器实现对终端的全面管理,包括列表、重命名、导航、创建、关闭、拆分和执行命令等功能。

  • by davidrsch
  • TypeScript
  • 云端部署
  • 更新于
在 GitHub 查看 davidrsch/vscode_terminal_automatization

使用说明

VS代码终端MCP

一个VS代码扩展,它公开了一个 MCP(模型上下文协议)服务器 因此,AI助手可以 列出、重命名、导航、创建、关闭、拆分和执行命令 在你的VS代码终端-使用真正的VS代码API,而不是浏览器自动化。

为什么要延期?

现有的MCP服务器在VS Code中没有提供一流的终端管理。该扩展通过在VS Code扩展主机内直接运行可流式HTTP MCP服务器来弥合这一差距,使AI代理可以直接访问 vscode.window.terminals.

工具

工具 说明
list_terminals 列出所有打开的终端,包括索引、名称、活动状态和shell集成可用性
get_active_terminal 获取当前聚焦终端的信息
focus_terminal 按名称或索引聚焦(显示)终端
create_terminal 使用可选名称、cwd和shell路径创建新终端
rename_terminal 按名称或索引重命名终端
close_terminal 按名称或索引关闭(处置)终端
send_text_to_terminal 向终端发送文本/命令,可选择按Enter键
split_terminal 从现有终端拆分终端窗格
hide_terminal 隐藏(折叠)终端面板而不关闭它
close_all_terminals 立即关闭所有打开的终端
run_command 运行shell命令并捕获输出(需要shell集成,VS代码1.93+)

安装

VS Code 应用商店

或搜索 “终端MCP” 在“扩展”视图中(Ctrl+Shift+X).

打开VSX

来自VSIX

code --install-extension terminal-automatization-*.vsix

设置

安装后,扩展程序:

  1. 启动MCP流式HTTP服务器——默认情况下 操作系统选择空闲端口 (港口 0),因此从不存在端口冲突。
  2. 在状态栏中显示实际端口——单击它可快速操作。
  3. 可以选择自动配置 .vscode/mcp.json 为您的MCP客户。

手动MCP配置

如果需要固定端口,请设置 terminalMcp.port 在您的设置中,然后添加到 .vscode/mcp.json:

{
  "servers": {
    "terminal-automatization": {
      "type": "http",
      "url": "http://localhost:<PORT>/mcp"
    }
  }
}

替换 <PORT> 状态栏中显示的端口,或您配置的端口。

配置

设置 默认值 说明
terminalMcp.port 0 HTTP服务器端口(0 =操作系统选择空闲端口)。为外部MCP客户端设置固定端口。
terminalMcp.enableHttpServer true 启动HTTP服务器。如果只使用VS Code的内置MCP,则禁用此选项——完全释放端口。
terminalMcp.autoConfigureMcpJson false 自动添加条目到 .vscode/mcp.json 在启动时。

命令

命令 描述
Terminal MCP: Show Status 显示服务器状态和快速操作
Terminal MCP: Copy MCP Configuration 将JSON配置复制到剪贴板
Terminal MCP: Add to .vscode/mcp.json 将配置写入工作区mcp.json
Terminal MCP: Restart Server 重新启动MCP服务器

需求

  • VS Code 1.99.0 或更高
  • 对于 run_command 输出捕获:启用shell集成的VS Code 1.93+

许可证

麻省理工学院