AI导哈

多语言调试桥接器

Watchtower是一个Windows原生的MCP与DAP桥接器，支持C#、Node/TS、Python和Dart等多种语言的逐步调试，提供统一的调试接口和高性能调试体验。

  • by rlaksana
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 rlaksana/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）

贡献

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

许可证

请参阅许可证文件。

相关 MCP