MCP Watchtower

守望台DAP Windows调试

Windows原生MCP⇄ DAP桥启用C#、Node/TS、Python和Dart的分步调试

概述

Watchtower是一个模型上下文协议（MCP）服务器，它在Windows上跨多种编程语言提供统一的调试功能。它充当MCP客户端和各种调试适配器之间的桥梁，为调试工作流提供一致的接口。

特性

• Windows本机：针对Windows 10/11进行了优化，具有Windows特定的适配器检测功能
• 多语言支持：C#（vsdbg/netcoredbg）、Node.js/TypeScript（vscode-js-debug）、Python（debugpy）、Dart/Flutter（DAP适配器）
• 统一MCP接口：通过MCP协议公开的所有13个必需的DAP工具
• 启动和连接：支持启动新流程和附加到正在运行的流程
• 确定性调试循环：带分页的基于光标的事件轮询
• 默认安全：在日志中编辑环境变量和命令行参数
• 高性能：首次中断时间≤1000ms，步进操作p95≤200ms
• 可观测性基础：OpenTetry指标和结构化日志记录

建筑

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   MCP Client    │───▶│  Watchtower     │───▶│ Debug Adapters  │
│   (Claude Code) │    │   Server        │    │  (DAP Clients) │
└─────────────────┘    └─────────────────┘    └─────────────────┘
                              │
                              ▼
                       ┌─────────────────┐
                       │  Event Ring     │
                       │  Buffer        │
                       └─────────────────┘

开发状态

• 规格说明: ✅ 完成
• 实施计划: ✅ 完成
• 任务和清单: ✅ 完成
• 分析: ✅ 完成（9.2/10评分）
• 实施: 🚧 第1阶段-设置

快速入门（Alpha）

# Install dependencies
npm install

# Build the project
npm run build

# Run the MCP server
npm start

# Or run directly
npx dist/watchtower serve

Alpha发布目标

• \[\]使用断点和步进进行Node.js调试
• \[\]使用断点和步进进行Python调试
• \[\]基本MCP工具覆盖范围（dap.start、dap.setBreakpoints等）
• \[\]与Claude Code MCP配置集成

需求

• Windows 10/11
• Node.js 22 LTS
• 目标语言调试适配器（自动检测）

宪法

该项目在 守望台章程 其原则包括：

• Windows本机焦点：v1中不支持Linux/WSL
• DAP作为唯一的真理来源：所有调试都通过DAP适配器进行
• 最小MCP工具表面：仅暴露基本工具
• 默认安全：默认情况下，重置和验证处于活动状态
• 可观测性基础：综合指标和日志记录

项目结构

mcp-watchtower/
├── src/                    # TypeScript source code
│   ├── adapters/           # Language-specific adapters
│   ├── server/             # MCP server implementation
│   ├── transport/          # DAP transport layer
│   ├── tools/              # MCP tool implementations
│   └── types/              # TypeScript type definitions
├── tests/                  # Test files
│   ├── contract/           # Contract tests
│   ├── integration/        # Integration tests
│   └── unit/               # Unit tests
├── docs/                   # Documentation
├── specs/                  # Specification documents
└── dist/                   # Built JavaScript artifacts

质量门

该项目包括以下方面的综合质量检查表：

• ✅ 需求验证：42个功能需求得到验证
• ✅ 质量门：所有维度的60个验证项目
• ✅ 释放准备就绪：65个项目跟踪阿尔法/贝塔/GA里程碑

实施阶段

1. 设置：项目初始化和工具
2. 基础的：核心基础设施（传输、会话、适配器）
3. 用户故事1：Node.js+Python调试（Alpha）
4. 用户故事2：多语言支持（测试版）
5. 用户故事3：远程连接（测试版）
6. 波兰语：文件、样品、CI、硬化（GA）

贡献

该项目遵循 实施任务 和 质量指南.

许可证

请参阅许可证文件。