Development Safety System - MCP Server

开发安全系统 - MCP 服务

一个 MCP（Model Control Protocol）服务，为大模型开发工作流提供会话连续性和沙盒安全保障。

🎯 核心目标

创建一个 MCP 服务，为 AI 辅助开发提供“从上次中断处精准继续”+“绝不破坏主应用”的功能。

✨ 主要功能

• 会话状态持久化：保存和恢复完整的开发会话上下文
• 沙盒管理：提供隔离的开发环境，支持安全试验
• 活动检测：通过文件监控，建议何时保存会话状态
• 安全同步：将已批准的更改可控地复制回主项目

🚀 快速开始

安装

# Clone the repository
git clone <repository-url>
cd dev-safety-mcp

# Install dependencies
pip install -r requirements.txt

# Install the package
pip install -e .

基本用法

1. 创建沙盒以安全地进行开发：

# Through MCP client
await create_sandbox("F:/my-project")

2. 休息时保存会话状态：

await save_session_state(
    operation="Add payment feature",
    current_step="Created component files", 
    next_steps=["Add API endpoints", "Test integration"],
    sandbox_path="F:/my-project-sandbox-session-20250604-143022",
    context={"feature": "payment", "priority": "high"}
)

3. 从上次中断处继续：

session = await load_session_state()
print(session['continuation_prompt'])

4. 将已批准的更改同步到主项目：

await sync_to_main(
    sandbox_path="F:/my-project-sandbox-session-20250604-143022",
    main_path="F:/my-project",
    files=["src/components/Payment.jsx", "src/api/payment.js"]
)

🛠️ 可用的 MCP 工具

create_sandbox

为项目创建隔离副本，以便安全地进行开发。

参数：

• project_path（str）：主项目的路径
• sandbox_name（str，可选）：沙盒的自定义名称

save_session_state

保存完整的会话上下文，以便稍后继续。

参数：

• operation（str）：描述正在进行的工作
• current_step（str）：刚刚完成的内容
• next_steps（List[str]）：接下来需要完成的事项
• sandbox_path（str）：正在使用的沙盒路径
• context（Dict）：其他上下文信息

load_session_state

加载最近的会话状态，并提供继续工作的提示词。

check_activity

监控沙盒中的文件活动，以建议何时保存状态。

参数：

• sandbox_path（str）：要监控的路径
• minutes（int，可选）：检查的时间范围（默认值：10）

sync_to_main

将沙盒中已批准的更改安全地复制到主项目。

参数：

• sandbox_path（str）：源沙盒路径
• main_path（str）：目标主项目路径
• files（List[str]，可选）：要同步的特定文件（默认值：所有已更改的文件）

commit_progress

手动提交当前进度，以防工作丢失。

参数：

• sandbox_path（str）：沙盒路径
• message（str，可选）：描述进度的提交消息

check_mcp_status

新增：检查 MCP 服务监控系统的运行状况和状态。

返回：

• 服务状态和心跳信息
• 进程 ID 和启动时间
• 服务似乎已停止时的健康警告

📁 项目结构

dev-safety-mcp/
├── README.md
├── requirements.txt
├── setup.py
├── config/
│   └── project_types.json
├── src/
│   ├── __init__.py
│   ├── mcp_server.py              # Main MCP server
│   ├── sandbox_manager.py         # Sandbox creation/management
│   ├── session_manager.py         # Session state persistence
│   ├── activity_monitor.py        # File-based activity detection
│   └── utils.py                   # Helper functions
├── tests/
│   ├── test_basic_functionality.py
│   └── test_with_real_project.py
└── examples/
    └── basic_workflow_example.py

🔧 开发工作流

1. 开始开发 - 使用 create_sandbox 创建沙盒
2. 安全地工作 - 所有更改都在隔离的沙盒中进行
3. 保存进度 - 休息时使用 save_session_state
4. 无缝继续 - 加载会话状态，从上次中断处精准继续
5. 部署更改 - 使用 sync_to_main 将已批准的更改复制回主项目

🛡️ 安全功能

• 沙盒隔离：开发期间绝不触碰主项目
• 自动备份：每次同步操作前都会创建备份
• 活动监控：在不活动期间建议保存状态
• 版本控制：在沙盒中使用 Git 分支跟踪更改
• 服务健康监控：内置状态监控，通过心跳文件跟踪运行状况
• 外部状态检查：使用独立脚本验证 MCP 服务的运行状况

📊 服务监控

dev-safety MCP 服务内置监控功能，可检测服务何时停止运行，确保你不会在不知情的情况下失去保护。

状态监控功能：

• 自动心跳文件 - 每 30 秒更新一次
• 启动通知 - 服务启动时会明确提示
• 外部状态检查器 - 独立的监控脚本
• 健康警告 - 服务似乎已停止时发出警报

使用外部状态检查器：

# Check if MCP server is running
python tools/check-mcp-status.py

# Example outputs:
# ✅ MCP server is ACTIVE (last seen: 15s ago)
# 🔴 MCP server appears DOWN ⚠️ (last seen: 5m ago)

状态文件位置：

• 文件：~/.dev-safety/mcp_status.json
• 更新：服务运行期间每 30 秒更新一次
• 内容：PID、启动时间、工具数量、健康状态

🧪 测试

# Run basic functionality tests
python -m pytest tests/test_basic_functionality.py

# Test with a real project
python -m pytest tests/test_with_real_project.py

# Run example workflow
python examples/basic_workflow_example.py

📋 要求

• Python 3.8+
• Git（用于沙盒版本控制）
• 兼容 MCP 的客户端（Claude Desktop 等）

🚧 实现状态

✅ 阶段 1：核心价值（当前）

• 提供会话连续性工具的 MCP 服务
• 用于安全开发的沙盒管理
• 会话状态持久化
• 基于文件的活动检测
• 手动延续会话

🔮 后续阶段

• 阶段 2：智能提示（基于计时器的监控、自动建议）
• 阶段 3：简单自动化（自动保存、健康检查）
• 阶段 4：高级功能（多界面支持、可视化监控）

📄 许可证

MIT 许可证 — 详情请参阅 LICENSE 文件。

🤝 贡献

1. Fork 此仓库
2. 创建功能分支
3. 进行修改
4. 为新功能添加测试
5. 提交 pull request

📞 支持

如有问题或疑问，请使用 GitHub issue 跟踪器。