使用说明
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
设置
安装后,扩展程序:
- 启动MCP流式HTTP服务器——默认情况下 操作系统选择空闲端口 (港口
0),因此从不存在端口冲突。 - 在状态栏中显示实际端口——单击它可快速操作。
- 可以选择自动配置
.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+
许可证
麻省理工学院
