vscode内部命令mcp服务器
项目介绍
VSCode 内部命令 MCP 服务器
🚀 基于 FastMCP 的 VSCode 扩展框架，将 VSCode 转变为一个 MCP（模型上下文协议）服务器，允许外部客户端通过 HTTP 流传输和服务器发送事件（SSE）执行 VSCode 内部命令。
✨ 功能
- 🌐 支持 HTTP 流传输：使用
text/event-stream协议，支持实时通信 - 🔧 执行 VSCode 命令：远程执行任意 VSCode 内部命令
- 📊 查询工作区信息：获取当前工作区状态和文件信息
- ⚡ 异步后台执行：支持异步命令执行，不阻塞用户界面
- ⏰ 可配置延迟：支持设置命令执行延迟
- 🛡️ 安全控制：可配置命令白名单机制
- 📡 实时状态监控：状态栏显示服务器运行状态
- 基于上述信息，我将原始内容翻译成英文 标准 MCP 协议：完全兼容模型上下文协议规范
- ⚡ 高性能：基于 FastMCP 框架，支持并发请求和会话管理
- 🩺 健康检查：内置健康检查端点
📦 安装
克隆项目
git clone https://github.com/bestk/vscode-internal-command-mcp-server
cd vscode-internal-command-mcp-server
2. 安装依赖
npm install
3. 编译项目
npm run compile
4. 在 VSCode 中安装
- 按
F5启动扩展开发主机 - 或打包为
.vsix文件安装
⚙️ 配置
在 VSCode 设置中配置服务器参数：
{
"vscode-internal-command-mcp-server.port": 8080,
"vscode-internal-command-mcp-server.host": "localhost",
"vscode-internal-command-mcp-server.autoStart": true,
"vscode-internal-command-mcp-server.asyncExecution": true,
"vscode-内部命令-mcp-server.executionDelay": 1000,
"vscode-internal-command-mcp-server.showAsyncNotifications": false,
"vscode-internal-command-mcp-server.allowedCommands": [
"editor.action.formatDocument",
"workbench.action.files.save",
"editor.action.clipboardCopyAction"
]
}
配置说明
| 配置项 | 类型 | 默认值 | 描述 |
|---|---|---|---|
port | number | 8080 | MCP 服务器端口 |
host | string | localhost | MCP 服务器主机地址 |
autoStart | boolean | true | 扩展激活时自动启动服务器 |
asyncExecution | boolean | true | 启用异步命令执行（立即返回，后台执行） |
executionDelay | number | 0 | 命令执行延迟（毫秒） |
showAsyncNotifications | boolean | false | 显示异步命令完成通知 |
allowedCommands | string[] | [] | 允许执行的命令列表（空数组表示允许所有命令） |
🚀 使用
启动服务器
- 自动启动：当扩展激活时自动启动（如果
autoStart为 true） - 手动启动
- 命令面板：
VSCode 内部命令 MCP 服务器：启动服务器 - 或点击状态栏中的 🚀 VSCode 内部命令 MCP 按钮
- 命令面板：
服务器地址
- MCP 端点：
http://localhost:8080/mcp - 健康检查：
http://localhost:8080/health
状态监控
- 状态栏显示：🚀 VSCode 内部命令 MCP 🟢（运行中）/ 🚀 VSCode 内部命令 MCP 🔴（已停止）
- 命令面板：
VSCode 内部命令 MCP 服务器：显示状态查看详细状态
🛠️ 可用工具（MCP 工具）
1. execute_vscode_command
执行 VSCode 内部命令
参数
{
command: string; // VSCode 命令 ID
arguments?: string[]; // 命令参数（可选）
}
异步执行响应示例
{
"success": true,
"async": true,
"taskId": "bg_task_1_1756952250790",
"message": "命令 'composer.cancelComposerStep' 已提交到后台执行，将在 1000ms 后执行",
"command": "composer.cancelComposerStep",
"arguments": [],
"executionDelay": 1000,
"queueLength": 1,
"taskStats": {
"total": 1,
"pending": 1,
"running": 0,
"completed": 0,
"failed": 0,
"cancelled": 0
}
}
2. list_vscode_commands
列出所有可用的 VSCode 命令
参数：无
返回：命令列表（前 20 条，超出部分显示省略号）
3. get_workspace_info
获取当前工作区信息
参数：无
返回
{
name: string; // 工作区名称
folders: Array<{
// 工作区文件夹
name: string;
uri: string;
}>;
activeEditor: string; // 当前活动编辑器文件路径
}
🔌 客户端连接
使用官方 MCP SDK
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
import { Client } from '@modelcontextprotocol/sdk/client/index.js';
const transport = new StreamableHTTPClientTransport(new URL('http://localhost:8080/mcp'), {
requestInit: {
headers: {
'Content-Type': 'application/json',
Accept: 'application/json, text/event-stream',
},
},
});
const client = new Client({
name: 'vscode-mcp-client',
version: '1.0.0',
});
// 连接并使用
await client.connect(transport);
// 调用工具
const result = await client.callTool({
name: 'execute_vscode_command',
arguments: {
command: 'editor.action.formatDocument',
},
});
console.log('命令结果:', result);
使用 Cursor
在 Cursor 中配置 MCP 服务器：
{
"mcpServers": {
"vscode-internal-commands": {
"url": "http://localhost:8080/mcp",
"transport": "http"
}
}
}
使用 curl 测试
# 健康检查
curl http://localhost:8080/health
# 列出工具
curl -X POST http://localhost:8080/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}'
# 执行命令
curl -X POST http://localhost:8080/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "execute_vscode_command",
"arguments": {
"command": "workbench.action.files.save"
}
}
}'
🏗️ 技术架构
核心组件
┌─────────────────────────┐
│ VSCode 扩展 │
├─────────────────────────┤
│ FastMcpServer │ ← 基于 FastMCP 框架
├─────────────────────────┤
│ ServerManager │ ← 服务器管理和状态
├─────────────────────────┤
│ CommandExecutor │ ← VSCode 命令执行器
├─────────────────────────┤
│ BackgroundTaskExecutor │ ← 后台任务执行器
├─────────────────────────┤
│ TaskProvider │ ← VS Code 任务提供者
└─────────────────────────┘
技术栈
- 框架：FastMCP TypeScript MCP 服务器框架
- 协议：模型上下文协议（MCP）
- 传输：HTTP 流传输与服务器发送事件（SSE）
- 验证：Zod 模式验证
- 平台：VSCode 扩展 API
- 异步执行：基于 setInterval 的后台任务队列
网络协议
- 传输类型：
httpStream - 内容类型：
text/event-stream - 支持协议：HTTP/1.1
- CORS：默认启用
异步执行机制
- 任务队列：基于 Map 数据结构的内存队列
- 执行器：使用 setInterval 定期检查待处理任务
- 状态管理：支持待处理、运行中、已完成、失败和取消状态。
- 延迟执行：支持配置延迟，任务在指定时间后执行
- 通知系统：可选执行完成通知
🔧 开发
项目结构
vscode-internal-command-mcp-server/
├── src/
│ ├── extension.ts # 扩展入口点
│ ├── fastMcpServer.ts # FastMCP 服务器实现
│ ├── serverManager.ts # 服务器管理器
│ ├── commandExecutor.ts # VSCode 命令执行器
│ ├── backgroundTaskExecutor.ts # 后台任务执行器
│ └── taskProvider.ts # VS Code 任务提供者
├── out/ # 编译输出
├── package.json # 扩展配置和依赖
├── tsconfig.json # TypeScript 配置
└── README.md # 项目文档
开发命令
# 开发模式编译
npm run compile
# 监视模式编译
npm run watch
# 启动开发
code . # 打开 VSCode，按 F5 启动调试
调试
- 在 VSCode 中打开项目
- 按
F5启动扩展开发主机 - 在新窗口中测试扩展功能
- 查看调试控制台输出
🧪 测试
使用内置测试工具
- 启动服务器后，使用命令：
VSCode 内部命令 MCP 服务器：测试 MCP 工具 - 选择要测试的工具
- 输入必要的参数
- 查看执行结果
使用 FastMCP CLI
# 使用 FastMCP 开发工具测试
npx fastmcp dev src/fastMcpServer.ts
# 使用 MCP Inspector 检查
npx fastmcp inspect src/fastMcpServer.ts
🛡️ 安全考虑
命令白名单
出于安全原因，建议配置 allowedCommands 白名单：
{
"vscode-internal-command-mcp-server.allowedCommands": [
"editor.action.formatDocument",
"workbench.action.files.save",
"workbench.action.files.saveAll",
"editor.action.clipboardCopyAction",
"editor.action.clipboardPasteAction"
]
}
网络安全
- 默认仅启用对
localhost的监控，防止外部访问 - 支持 CORS，但在生产环境中建议配置适当的源限制
- 所有命令执行都在 VSCode 安全上下文中进行
异步执行安全
- 任务队列在内存中管理，并在扩展关闭时自动清理
- 支持任务取消和状态监控
- 执行失败时提供详细的错误消息
📝 更新日志
v0.0.2（当前版本）
- 重构异步执行机制，使用后台任务队列
- ✅ 解决配置刷新问题，确保配置更改立即生效
- ✅ 优化任务状态管理和监控
- ✅ 提升错误处理和日志记录
- 简化代码结构，移除冗余组件
v0.0.1
- ✅ 实现基于 FastMCP 框架的 MCP 服务器
- ✅ 支持 HTTP 流传输和 SSE
- ✅ 实现三个核心工具：命令执行、命令列表、工作区信息
- ✅ 状态栏集成和实时监控
- ✅ 健康检查端点
- ✅ Zod 模式参数验证
- ✅ 支持 TypeScript 5.9+
🤝 贡献
欢迎提交 Issues 和 Pull Requests！
开发指南
- 分叉项目
- 创建功能分支：
git checkout -b feature/amazing-feature - 提交更改：
git commit -m '添加神奇功能' - 推送分支：
git push origin feature/amazing-feature - 创建 Pull Request
许可证
MIT 许可证 - 详情见 LICENSE 文件
🙏 致谢
📞 支持
如果您遇到任何问题或有任何疑问：
- 查看 Issues
- 创建新的 Issue
- 查看 FastMCP 文档：https://github.com/punkpeye/fastmcp
🚀 将 VSCode 转变为您的 MCP 服务器，解锁无限可能！