Skip to content

Commit 8df8b1b

Browse files
markomanninenclaude
andcommitted
feat: Add Windows support for main repository
Changes: - Add setup.bat for Windows users - Update README.md with separate instructions for Windows - Windows batch script mirrors setup.sh functionality - Fix markdown linting warnings (blank lines around fences) Windows users can now: - Run setup.bat for automated environment setup - Use .venv\Scripts\activate for activation - All paths updated for Windows (backslashes) Both Unix/macOS (setup.sh) and Windows (setup.bat) are now fully supported. 🤖 Generated with Claude Code Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 625015f commit 8df8b1b

2 files changed

Lines changed: 100 additions & 3 deletions

File tree

README.md

Lines changed: 18 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,15 +13,30 @@ Enable AI agents to debug your Python code through natural language. This MCP se
1313

1414
## Quick start
1515

16+
**macOS/Linux:**
17+
1618
```bash
1719
git clone <this-folder>
1820
cd mvp-agent-debug
1921
./setup.sh
2022

21-
# In a new terminal, activate the venv and run demos/tests as needed:
23+
# Activate the venv and run demos/tests:
2224
source .venv/bin/activate
23-
python src/dap_stdio_direct.py # direct adapter walkthrough (waits for breakpoint)
24-
python -m pytest tests/test_mcp_server.py # verify MCP tooling via fakes
25+
python src/dap_stdio_direct.py # direct adapter walkthrough
26+
python -m pytest tests/test_mcp_server.py # verify MCP tooling
27+
```
28+
29+
**Windows:**
30+
31+
```cmd
32+
git clone <this-folder>
33+
cd mvp-agent-debug
34+
setup.bat
35+
36+
REM Activate the venv and run demos/tests:
37+
.venv\Scripts\activate
38+
python src\dap_stdio_direct.py
39+
python -m pytest tests\test_mcp_server.py
2540
```
2641

2742
Install (from source):

setup.bat

Lines changed: 82 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,82 @@
1+
@echo off
2+
REM Setup script for mcp-debugpy (Windows)
3+
4+
echo ========================================
5+
echo Setting up mcp-debugpy development environment
6+
echo ========================================
7+
echo.
8+
9+
REM Check Python
10+
python --version >nul 2>&1
11+
if errorlevel 1 (
12+
echo ERROR: Python not found. Please install Python 3.8 or higher.
13+
exit /b 1
14+
)
15+
16+
REM Create virtual environment
17+
echo Creating virtual environment...
18+
python -m venv .venv
19+
if errorlevel 1 (
20+
echo ERROR: Failed to create virtual environment
21+
exit /b 1
22+
)
23+
echo.
24+
25+
REM Activate virtual environment
26+
echo Activating virtual environment...
27+
call .venv\Scripts\activate.bat
28+
if errorlevel 1 (
29+
echo ERROR: Failed to activate virtual environment
30+
exit /b 1
31+
)
32+
echo.
33+
34+
REM Upgrade pip
35+
echo Upgrading pip...
36+
python -m pip install --upgrade pip
37+
if errorlevel 1 (
38+
echo WARNING: Failed to upgrade pip, continuing anyway...
39+
)
40+
echo.
41+
42+
REM Install runtime dependencies
43+
echo Installing runtime dependencies...
44+
pip install -r requirements.txt
45+
if errorlevel 1 (
46+
echo ERROR: Failed to install runtime dependencies
47+
exit /b 1
48+
)
49+
echo.
50+
51+
REM Install development dependencies
52+
echo Installing development dependencies...
53+
pip install -r requirements-dev.txt
54+
if errorlevel 1 (
55+
echo ERROR: Failed to install development dependencies
56+
exit /b 1
57+
)
58+
echo.
59+
60+
REM Run smoke tests
61+
echo ========================================
62+
echo Smoke-testing MCP tooling and examples
63+
echo ========================================
64+
python -m pytest tests\test_mcp_server.py examples\math_bug\tests examples\async_worker\tests examples\gui_counter\tests examples\web_flask\tests
65+
REM Continue even if tests fail (|| true equivalent)
66+
echo.
67+
68+
REM Display next steps
69+
echo ========================================
70+
echo Setup complete!
71+
echo ========================================
72+
echo.
73+
echo Next steps:
74+
echo .venv\Scripts\activate
75+
echo python scripts\configure_mcp_clients.py # register VS Code / Claude MCP entries
76+
echo # ...or follow docs\mcp_usage.md for manual configuration details
77+
echo python src\dap_stdio_direct.py # optional direct adapter walkthrough
78+
echo # After configuration, use your MCP chat to call run_tests_json, dap_launch, etc.
79+
echo.
80+
echo Each example README (examples\*\README.md) shows how to launch via dap_launch.
81+
echo.
82+
pause

0 commit comments

Comments
 (0)