# Dev Assistant MCP Server v2.0

**你的电脑 = 全自动代码开发服务器。** 19 个工具覆盖完整开发生命周期，从项目扫描到 Git 提交，全程自动化。无需外部 API Key，Windsurf (Cascade) 自身模型完成所有智能决策。

## 工作原理

```
你说一句话 → Cascade 自动编排工具链 → 本地执行全部操作 → 返回结果
     ↑                                                      ↓
     └──── 自动判断：通过? → 完成 / 有错? → 修复再验证 ←────┘
```

**极致闭环**：Cascade 连续多轮调用工具，自动：扫描 → 编码 → 检查 → 修复 → 构建 → 测试 → 提交，直到完美。

## 19 个工具

### 🔍 代码分析（4）

| 工具 | 功能 |
|------|------|
| `code_review` | 代码审查（安全/性能/风格模式匹配 + 检查清单） |
| `code_write` | 代码编写指引（最佳实践 + 框架骨架模板） |
| `code_debug` | 调试分析（7 类错误自动分类 + 修复策略） |
| `doc_write` | 文档生成（代码结构提取 + 5 种文档模板） |

### ⚡ 本地执行（6）

| 工具 | 功能 |
|------|------|
| `exec_command` | 执行任意本地 Shell 命令 |
| `lint_check` | 代码检查（自动检测 ESLint/tsc/flake8） |
| `auto_fix` | 自动修复（Prettier + ESLint --fix + autopep8） |
| `run_tests` | 运行测试（自动检测 Jest/Vitest/Pytest） |
| `build_project` | 构建项目并捕获编译错误 |
| `project_scan` | 扫描项目结构/技术栈/依赖/脚本 |

### 📁 文件操作（3）

| 工具 | 功能 |
|------|------|
| `read_local_file` | 读取本地文件（带行号） |
| `write_local_file` | 写入/创建文件（自动创建目录） |
| `patch_file` | 精确查找替换（自动纠错修改代码） |

### 🚀 高级工具（6）

| 工具 | 功能 |
|------|------|
| `git_ops` | Git 全套操作（status/diff/add/commit/push/pull/branch/stash/reset） |
| `dep_manage` | 依赖管理（安装/更新/删除/安全审计/过时检查） |
| `search_code` | 项目内代码搜索（正则/文本/符号/文件名） |
| `dev_server` | 开发服务器管理（启动/停止/重启/日志/状态） |
| `env_check` | 环境检测（Node/Python/Git 版本/端口/CPU/内存/磁盘） |
| `workflow` | 工作流编排（一键执行 CI 流水线，6 种预设 + 自定义） |

### 📚 资源（3）

| 资源 | 说明 |
|------|------|
| 编码规范 | TypeScript / Python 最佳实践 |
| 调试指南 | 常见错误模式和排查方法 |
| 文档模板 | README、API 文档、CHANGELOG 标准模板 |

## Workflow 预设流水线

| 预设 | 步骤 | 适用场景 |
|------|------|---------|
| `full_check` | scan → lint → build → test | 全量质量检查 |
| `fix_and_verify` | fix → lint → build → test | 自动修复后验证 |
| `pre_commit` | lint → build → test → git status | 提交前检查 |
| `ci_simulate` | install → lint → build → test → audit | 模拟 CI 流程 |
| `quick_scan` | scan → lint | 快速扫描 |
| `deploy_prep` | lint → build → test → git status | 部署前准备 |

## 快速开始

### 1. 安装和构建

```bash
cd dev-assistant-mcp
npm install
npm run build
```

### 2. Windsurf 配置

编辑 `C:\Users\UI\.codeium\windsurf\mcp_config.json`：

```json
{
  "mcpServers": {
    "dev-assistant": {
      "command": "D:\\Software\\Node\\node.exe",
      "args": ["C:\\Users\\UI\\Desktop\\bigwo\\dev-assistant-mcp\\dist\\index.js"]
    }
  }
}
```

保存后重启 Windsurf。

### 3. 使用示例

```
"扫描 test2 项目"                    → project_scan
"检查代码质量并自动修复"              → lint_check + auto_fix
"构建项目，有错自动修"               → build_project + code_debug + patch_file
"运行全量 CI 流水线"                 → workflow preset=ci_simulate
"搜索所有用到 fetchData 的地方"       → search_code
"查看 git 状态并提交"                → git_ops status → add_all → commit
"启动开发服务器"                     → dev_server start
"检查我的开发环境"                   → env_check
"安装 lodash 并审计安全漏洞"          → dep_manage add + audit
"提交前检查一遍"                     → workflow preset=pre_commit
```

## 项目结构

```
dev-assistant-mcp/
├── src/
│   ├── index.ts                  # MCP Server 入口（19 工具 + 3 资源）
│   ├── tools/
│   │   ├── codeReview.ts         # 代码审查
│   │   ├── codeWrite.ts          # 代码编写指引
│   │   ├── codeDebug.ts          # 调试分析
│   │   ├── docWrite.ts           # 文档生成
│   │   ├── execCommand.ts        # 本地命令执行
│   │   ├── lintCheck.ts          # 代码质量检查
│   │   ├── autoFix.ts            # 自动修复
│   │   ├── runTests.ts           # 运行测试
│   │   ├── buildProject.ts       # 构建项目
│   │   ├── projectScan.ts        # 项目扫描
│   │   ├── fileOps.ts            # 文件读写/修改
│   │   ├── gitOps.ts             # Git 操作
│   │   ├── depManage.ts          # 依赖管理
│   │   ├── searchCode.ts         # 代码搜索
│   │   ├── devServer.ts          # 开发服务器管理
│   │   ├── envCheck.ts           # 环境检测
│   │   └── workflow.ts           # 工作流编排
│   └── resources/
│       ├── codingStandards.ts    # 编码规范
│       ├── debugGuide.ts         # 调试指南
│       └── docTemplates.ts       # 文档模板
├── dist/                          # 编译输出
├── package.json
├── tsconfig.json
└── README.md
```

## License

MIT