VSCode Internal Command MCP Server

🚀 一个基于 FastMCP 框架的 VSCode 扩展，将 VSCode 转换为 MCP (Model Context Protocol) 服务器，支持外部客户端通过 HTTP Streaming 和 Server-Sent Events (SSE) 执行 VSCode 内部命令。

✨ 功能特性

🌐 HTTP Streaming 支持: 使用 text/event-stream 协议，支持实时通信
🔧 VSCode 命令执行: 远程执行任意 VSCode 内部命令
📊 工作区信息查询: 获取当前工作区状态和文件信息
🛡️ 安全控制: 可配置的命令白名单机制
📡 实时状态监控: 状态栏显示服务器运行状态
🔗 标准 MCP 协议: 完全兼容 Model Context Protocol 规范
⚡ 高性能: 基于 FastMCP 框架，支持并发请求和会话管理
🩺 健康检查: 内置健康检查端点

📦 安装

1. 克隆项目

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 设置中配置服务器参数：

{
    "vscodeICommandMcpServer.port": 8080,
    "vscodeICommandMcpServer.host": "localhost",
    "vscodeICommandMcpServer.autoStart": true,
    "vscodeICommandMcpServer.enableWebSocket": true,
    "vscodeICommandMcpServer.allowedCommands": [
        "editor.action.formatDocument",
        "workbench.action.files.save",
        "editor.action.clipboardCopyAction"
    ]
}

配置说明

配置项	类型	默认值	说明
`port`	number	8080	MCP 服务器端口
`host`	string	"localhost"	MCP 服务器主机地址
`autoStart`	boolean	true	扩展激活时自动启动服务器
`enableWebSocket`	boolean	true	启用 WebSocket 支持（未来功能）
`allowedCommands`	string[]	[]	允许执行的命令列表（空数组表示允许所有命令）

🚀 使用方法

启动服务器

自动启动: 扩展激活时自动启动（如果 autoStart 为 true）
手动启动:
- 命令面板: VSCode MCP Server: Start Server
- 或点击状态栏中的 🚀 FastMCP 按钮

服务器地址

MCP 端点: http://localhost:8080/mcp
健康检查: http://localhost:8080/health

状态监控

状态栏显示: 🚀 FastMCP 🟢 (运行中) / 🚀 FastMCP 🔴 (已停止)
命令面板: VSCode MCP Server: Show Status 查看详细状态

🛠️ 可用工具 (MCP Tools)

1. execute_vscode_command

执行 VSCode 内部命令

参数:

{
  command: string;      // VSCode 命令 ID
  arguments?: string[]; // 命令参数（可选）
}

示例:

{
    "name": "execute_vscode_command",
    "arguments": {
        "command": "editor.action.formatDocument",
        "arguments": []
    }
}

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('Command result:', 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 Extension  │
├─────────────────────┤
│   FastMcpServer     │ ← 基于 FastMCP 框架
├─────────────────────┤
│   ServerManager     │ ← 服务器管理和状态
├─────────────────────┤
│   CommandExecutor   │ ← VSCode 命令执行器
└─────────────────────┘

技术栈

框架: FastMCP - TypeScript MCP 服务器框架
协议: Model Context Protocol (MCP)
传输: HTTP Streaming with Server-Sent Events (SSE)
验证: Zod Schema 验证
平台: VSCode Extension API

网络协议

传输类型: httpStream
内容类型: text/event-stream
支持协议: HTTP/1.1, WebSocket (计划中)
CORS: 默认启用

🔧 开发

项目结构

cursor-command-http/
├── src/
│   ├── extension.ts        # 扩展入口点
│   ├── fastMcpServer.ts    # FastMCP 服务器实现
│   ├── serverManager.ts    # 服务器管理器
│   ├── commandExecutor.ts  # VSCode 命令执行器
│   └── mcpServer.ts        # 原始 MCP 服务器（备用）
├── out/                    # 编译输出
├── package.json           # 扩展配置和依赖
├── tsconfig.json          # TypeScript 配置
└── README.md              # 项目文档

开发命令

# 开发模式编译
npm run compile

# 监视模式编译
npm run watch

# 启动开发
code . # 打开 VSCode，按 F5 启动调试

调试

在 VSCode 中打开项目
按 F5 启动扩展开发主机
在新窗口中测试扩展功能
查看调试控制台输出

🧪 测试

使用内置测试工具

启动服务器后，使用命令: VSCode MCP Server: Test MCP Tools
选择要测试的工具
输入必要的参数
查看执行结果

使用 FastMCP CLI

# 使用 FastMCP 开发工具测试
npx fastmcp dev src/fastMcpServer.ts

# 使用 MCP Inspector 检查
npx fastmcp inspect src/fastMcpServer.ts

🛡️ 安全考虑

命令白名单

为了安全起见，建议配置 allowedCommands 白名单：

{
    "vscodeICommandMcpServer.allowedCommands": [
        "editor.action.formatDocument",
        "workbench.action.files.save",
        "workbench.action.files.saveAll",
        "editor.action.clipboardCopyAction",
        "editor.action.clipboardPasteAction"
    ]
}

网络安全

默认只监听 localhost，避免外部访问
支持 CORS，但建议在生产环境中配置适当的源限制
所有命令执行都在 VSCode 安全上下文中进行

📝 更新日志

v0.0.1 (当前版本)

✅ 基于 FastMCP 框架实现 MCP 服务器
✅ 支持 HTTP Streaming 和 SSE
✅ 实现三个核心工具：命令执行、命令列表、工作区信息
✅ 状态栏集成和实时监控
✅ 健康检查端点
✅ Zod Schema 参数验证
✅ TypeScript 5.9+ 支持

🤝 贡献

欢迎提交 Issue 和 Pull Request！

开发指南

Fork 项目
创建功能分支: git checkout -b feature/amazing-feature
提交更改: git commit -m 'Add amazing feature'
推送分支: git push origin feature/amazing-feature
创建 Pull Request

📄 许可证

MIT License - 详见 LICENSE 文件

🙏 致谢

FastMCP - 优秀的 TypeScript MCP 框架
Model Context Protocol - 标准协议规范
VSCode Extension API - 强大的扩展平台

📞 支持

如果您遇到问题或有疑问：

查看 Issues
创建新的 Issue
查看 FastMCP 文档: https://github.com/punkpeye/fastmcp

🚀 让 VSCode 成为您的 MCP 服务器，释放无限可能！

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Converts VSCode into an MCP server that enables external clients to remotely execute VSCode internal commands, query workspace information, and interact with the editor through HTTP streaming. Built on the FastMCP framework with security controls and real-time monitoring.

Related MCP Servers

language-server-mcp
alexwohletz
A
security
A
license
A
quality
TypeScript-based MCP server designed to enhance code editing experiences by providing features such as hover information, code completion, and diagnostics.
Last updated -
3
24
MIT License
vscode-mcp-server
juehang
A
security
A
license
A
quality
vscode-mcp-server
Last updated -
9
582
214
MIT License
CopilotMCP
mehrshadshams
-
security
F
license
-
quality
A collection of MCP servers built with FastMCP framework that handle various tasks including customer interviews, E2E testing, and go-live processes, enabling seamless integration with GitHub Copilot through VSCode.
Last updated -
MCP Server Demo
elvisleyva49
-
security
F
license
-
quality
A minimal WebSocket-based MCP server implementation that enables modern tool integrations with VSCode, Claude, and other applications.
Last updated -
1

View all related MCP servers