Pdb Debug

PDB调试网关

一个全面的REST API和MCP服务器，用于使用pdb进行远程Python调试。

🚀 特性

• 远程调试：通过REST API调用调试Python应用程序
• AI辅助调试：Claude Code的MCP服务器集成
• 会话管理：多个并发调试会话
• 综合录井：调试操作的完整审计跟踪
• 多种断点类型：常规断点、条件断点和临时断点
• 计量检验：变量和表达式的实时检查
• 逐步执行：对代码执行流的程序化控制

🎯 这能带来什么

AI辅助调试

• Claude Code可以在可疑代码位置自动设置断点
• AI可以通过执行来理解程序流程
• 智能变量检查，以识别数据损坏或逻辑错误
• 带有根本原因分析的自动调试报告

大规模远程调试

• 在没有直接服务器访问的情况下调试生产系统
• 与多个开发人员协同调试
• 集成到CI/CD中的自动化调试管道
• 容器化应用程序的云原生调试

📁 存储库结构

pdb-debug/
├── pdb-rest-gateway/          # Main PDB Gateway implementation
│   ├── src/pdb_gateway/       # Core library code
│   │   ├── api/              # REST API endpoints
│   │   ├── core/             # Debugging engine and session management
│   │   ├── mcp/              # MCP server implementation
│   │   └── schemas/          # Request/response schemas
│   ├── simple_server.py      # Standalone REST API server
│   ├── mcp_server.py         # MCP server for Claude Code
│   ├── requirements.txt      # Python dependencies
│   └── *.py                  # Test and demo scripts
├── breakpoint-simulation/     # Test applications and demos
│   ├── data_processor.py     # Sample data processing pipeline (295 lines)
│   ├── test_*.py            # Comprehensive test suites
│   └── *.md                 # Testing documentation
├── CLAUDE.md                 # Complete integration guide
└── README.md                # This file

🚀 快速开始

1.启动PDB网关服务器

# REST API server (port 8002)
cd pdb-rest-gateway
python3 simple_server.py

# OR MCP server for Claude Code integration
python3 mcp_server.py

2.使用样品应用程序进行测试

# Run comprehensive debugging tests
python3 breakpoint-simulation/test_with_logging.py

# Test real debugging scenarios
python3 breakpoint-simulation/test_debugging.py

# Analyze debugging logs
python3 pdb-rest-gateway/view_logs.py

3.调试自己的应用程序

# Create debug session via REST API
curl -X POST http://localhost:8002/debug/sessions \
  -H "Content-Type: application/json" \
  -d '{"target_file": "your_script.py"}'

# Set breakpoint
curl -X POST http://localhost:8002/debug/sessions/{session_id}/breakpoint \
  -H "Content-Type: application/json" \
  -d '{"filename": "your_script.py", "line_number": 25}'

# Step through execution
curl -X POST http://localhost:8002/debug/sessions/{session_id}/step \
  -H "Content-Type: application/json" \
  -d '{"step_type": "continue"}'

🔧 REST API端点

🤖 面向人工智能助理的MCP工具

当配置为MCP服务器时，为Claude Code提供以下工具：

• pdb_start_session -初始化调试会话
• pdb_set_breakpoint -设置/删除断点
• pdb_step -逐步执行代码
• pdb_inspect -检查变量和表达式
• pdb_execute -执行任意PDB命令
• pdb_list_sessions -列出活动会话
• pdb_terminate_session -结束调试会话

📊 测试结果

我们的全面测试表明：

• 47次操作 执行时间为0.817秒（57.5次操作/秒）
• 10个断点 set（常规、有条件、临时）
• 8步操作 （接下来，继续，逐步计数）
• 14次可变检查 （简单的变量，复杂的表达式）
• 13次命令执行 （list、where、args、local等）
• 完成日志记录 具有29.8 KB的审计跟踪

🎯 用例

开发与调试

• 复杂应用程序的交互式调试
• 生产问题的根本原因分析
• 代码行为理解和文档
• 性能瓶颈识别

人工智能辅助开发

• 自动错误检测和分析
• 智能代码审查和建议
• 教育代码演练
• 调试知识捕获和共享

企业应用程序

• 审核是否符合完整的操作日志记录
• 调试活动的安全监控
• 跨团队协作调试
• 与CI/CD管道集成

📋 需求

• Python 3.7+
• 标准库模块（pdb、线程、json等）
• 可选：REST服务器的FastAPI
• 可选：用于Claude Code集成的MCP库

🔍 日志记录与监视

所有调试操作均以以下方式记录：

• 所有操作的时间戳跟踪
• 每个操作的成功/失败状态
• 完整的参数值和结果
• 会话持续时间和性能指标
• 错误跟踪和调试信息

通过以下方式查看日志：

python3 pdb-rest-gateway/view_logs.py
tail -f pdb-rest-gateway/pdb_gateway.log

🚀 未来的可能性

• 预测性调试 -AI预测漏洞会发生在哪里
• 自我修复代码 -自我调试和修复的系统
• 智能监控 -实时系统的持续调试
• 代码优化 -AI根据执行分析提出改进建议

📖 文档

看 CLAUDE.md 完整的集成指南包括：

• ETL系统集成示例
• 自然语言调试命令
• 全面的API文件
• 故障排除和最佳实践

______________________________________________________________________

🎯 该工具彻底改变了Python调试，使其可编程、远程、智能和可扩展！