Vscode MCP Debug

VS Code Python的MCP调试器（目前……）

免责声明： 大部分内容是基于Copilot（GPT-5迷你版和Sonnet 4.5）作为起点编写的，以便我从中学习。随着我的学习过程，越来越多的代码正在/将会被我自己的代码所更新。

基本描述： 一个Visual Studio Code扩展，以及一个轻量级的MCP（模型上下文协议）服务器，用于集中监控和分析，可被AI代理（如Copilot）使用。

数据通过内置的VS Code调试器收集，然后传输到服务器上，作为MCP主机，Copilot（以及其他工具）可以直接访问这些数据。

目前它仅支持调试Python，但计划是也支持JS/TS。在理想的工作状态下，它将足够智能，能够调试当前文件所使用的任何语言。

✨ 特点

• 🔍（放大镜图标，常用于表示搜索、查找或观察细节） 实时调试监控捕获变量、堆栈跟踪和控制台输出
• 🚀 表情符号“🚀”在中文中通常被翻译为“火箭”或直接保留为“🚀”，用于表示快速前进、加速或发射等含义。在没有具体上下文的情况下，可以简单地将其理解为“火箭”或“🚀”。 MCP集成采用FastMCP构建，实现工具无缝集成
• 📡（卫星天线或无线电信号的象征） RESTful API（Representational State Transfer应用程序编程接口）通过HTTP端点轻松访问调试数据
• ⚙️（齿轮符号，常用于表示机械、设置或调整等含义） 可配置的可定制的服务器URL以及启用/禁用选项
• 🧪 试管/实验器材（表示与实验或化学相关的物品） 经过充分测试全面的测试套件

🎯 使用场景

• 调试会话分析监控变量变化和执行流程
• 远程调试可能将多个 VS Code 实例的调试数据集中到一个数据库中
• 教育使用可视化数据流教授调试概念。以该工具为例，展示如何为Python及其他语言构建新的调试工具
• 自动化将调试信息集成到CI/CD流水线/人工智能代理工作流中

🚀 快速入门

选项A：全局安装（推荐用于多工作区使用）

安装一次，随处可用！服务器全球运行，适用于您的所有Python项目。

# Linux/macOS/WSL
chmod +x install-global.sh
./install-global.sh
source ~/.bashrc
mcp-debug-server

# Windows PowerShell
.\install-global.ps1
# Restart PowerShell, then:
powershell "$env:USERPROFILE\.local\bin\mcp-debug-server.ps1"

见 全球设置指南 以获取详细说明。

选项B：针对特定工作区的安装

1. 安装

- 使用随附的服务器设置脚本： server-install.sh （或 server-install.ps1 （针对PowerShell用户） - 使用随附的扩展设置脚本： extension-install.sh （或 extension-install.ps1 （针对PS用户） 注： Shell 脚本需要执行权限\[^1\]。

或者。。。

从项目根目录安装Python包\[^2\]：

   cd server && python3 -m venv venv
   source venv/bin/activate
   # Install server dependencies
   pip install -r requirements.txt

   cd ..

   # Install extension dependencies
   cd extension && npm install && npm run compile

从项目根目录安装 Node 模块：

   cd extension
   npm i

1. 启动服务器

Linux/MacOS/WSL\[^2\]（注：WSL表示Windows Subsystem for Linux，即Windows上的Linux子系统）：

   cd server && source venv/bin/activate && python3 -m uvicorn main:app --host 127.0.0.1 --port 8001

1. 打开 VS Code 在这个工作区中

1. 开始调试 任何Python文件（F5）

1. 查看调试数据 在 http://localhost:8001/debug-data

🏗️ 建筑学

graph LR
    A[VS Code Debugger] --> B[Extension]
    B -->|HTTP POST| C[FastAPI Server]
    C --> D[MCP Tools]
    C --> E[Data Store]
    E -->|HTTP GET| F[REST API Client]

📚 文档

• 概述 - 概述
• 全球设置指南 - 在全局层面完成安装和配置
• 设置指南 - 完成安装和配置
• API 参考文档 - HTTP终端点文档
• 样本测试结果 - 样品测试验证及结果

🔗 API 端点

🛠️ 开发

先决条件

• Python 3.8及以上版本
• Node.js 16及以上版本
• 带有Python扩展的VS Code

设置

cd server && source venv/bin/activate
# Install server dependencies
pip install -r requirements.txt

cd ..

# Install extension dependencies
cd extension && npm install && npm run compile

测试

# Run comprehensive test suite
python comprehensive_test.py

# Test specific components
python test_extension_flow.py

📁 项目结构

vscode-debug-mcp/
├── 📄 README.md                      # This file
├── 📄 Makefile                       # Build automation
├── 📁 docs/                          # Documentation
│   ├── SETUP_GUIDE.md                # Detailed setup instructions
│   ├── TEST_RESULTS.md               # Test verification results
│   ├── API_REFERENCE.md              # API documentation
│   └── OVERVIEW.md                   # Project overview
├── 🔧 scripts/                       # Utility and helper scripts
│   ├── check_endpoints.sh            # Endpoint smoke test script
│   ├── extension_simulator.sh        # Simulates extension network behavior
│   ├── example_mcp_client.py         # Minimal MCP client example
│   ├── inspect_routes.py             # Inspect registered app routes
│   ├── install-global.sh             # Global installer (Linux/Mac)
│   ├── install-global.ps1            # Global installer (PowerShell)
│   ├── server-install.sh             # Server setup script (Linux/Mac)
│   ├── server-install.ps1            # Server setup script (PowerShell)
│   ├── server-start.sh               # Start the server script
│   ├── clean-up.sh                   # Cleanup script (Linux/Mac)
│   ├── CleanUp.ps1                   # Cleanup script (Windows)
│   ├── run_ci_checks.sh              # CI-style wrapper for checks
│   └── (more scripts...)             # other helper scripts
├── 🔧 extension/                     # VS Code extension
│   ├── src/                          # TypeScript source
│   │   └── extension.ts              # Extension source code
│   ├── dist/                         # Compiled extension
│   ├── package.json                  # Extension manifest
│   ├── tsconfig.json                 # TypeScript configuration
│   └── README.md                     # Extension dev instructions
├── 🖥️ server/                        # MCP server
│   ├── main.py                       # FastAPI application
│   ├── main_simple.py                # Simplified server version
│   ├── tools.py                      # MCP tools definitions
│   ├── store.py                      # Data storage layer
│   ├── requirements.txt              # Python dependencies
│   └── tests/                        # Server tests
│       ├── 🧪 test_debug.py          # Sample debug script
│       ├── 🧪 test_extension_flow.py # Extension flow tests
│       └── 🧪 comprehensive_test.py  # Full system tests
├── 📄 tasks.py                       # Task automation
├── 📄 LICENSE                        # Project license (MIT)
└── ⚙️ .vscode/                       # VS Code configuration
    └── launch.json                   # Debug configuration

🤝 贡献（或：参与贡献）

欢迎贡献！请随时提交拉取请求。对于重大更改，请先打开一个问题进行讨论，说明您希望做出哪些更改。

📝 许可证

这个项目采用MIT许可证授权——详见 许可证 详情请查阅文件。

🙏 致谢

• 构建于 FastMCP 用于MCP（多芯片模块/多控制器协议等，具体含义需根据上下文确定）集成
• 用途 FastAPI 对于网络服务器

______________________________________________________________________

脚注

\[^1\]: 使用 chmod u+x file_name.sh 对于每个Linux文件，或者 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser 用于 PowerShell \[^2\]: Windows PowerShell 使用 python 代替 python3