使用说明
开发助理mcp服务器
用于令牌优化的通用开发辅助MCP服务器。
不要将整个文件粘贴到Claude上下文中,而是只查询所需的部分以减少令牌的使用。
🛡️ 工程标准:手术调试与策略
使用此MCP服务器的所有AI代理 五阶段工程标准必须严格遵守。这是为了用最少的令牌确保最大的精度。
-
查看现象(Observe Symptoms First)
- 在修改代码之前,
jarvis_status通过日志文件等收集真实证据(Raw Evidence)。 - 不仅根据假设进行编码,必须在确认实际状态后开始工作。
- 在修改代码之前,
-
原因反向追踪(Root Cause Tracing)
- 从症状开始
fs_search_in_file等,追溯代码,查找根本原因。 Input → Processing → Output标识在的流中发生错误的最前面的点。
- 从症状开始
-
依赖关系排序(Dependency Ordering)
- 如果有多个问题,请按依赖性顺序排序。
- 问“如果不修复A,是否可以测试B?”以确定先行任务。
-
精确修改(Surgical Precision)
fs_read_file只读取所需的部分,修改正确的文件路径和代码块,不含糊。- 修改后必须经过验证。
-
以目标为中心的设计(Purpose-Centric Design)
- 所有功能都是根据您对“解决实际问题”的贡献而设计的。
- 比起不必要的整体负载,更注重核心逻辑的精密操作。
📋 变更历史记录
日期区分内容
|------|------|------|
| 2026-04-29 | 🛡️ DOCS |添加“Engineering Standards:Surgical Debugging&Strategy”守则
| 2026-04-01 | 🆕 新 changelog_add / changelog_view 添加工具-自动记录README变更历史|
| 2026-04-01 | 🆕 新 reversal_* 添加5个工具(仅用于Reversal游戏项目)|
| 2026-04-01 | 🔧 修复| jarvis_status 修改Windows兼容性(ps aux → wmic) |
| 2026-04-01 | 🔧 修复| jarvis_list_packages 默认的Python路径 python3 → python |
| 2026-04-01 | 🆕 新 .exe 配置单个文件构建(npm run build:exe) |
| 2026-04-01 | 🆕 配置NEW|Watch Mode-保存时自动 .exe 重新构建(npm run watch:exe) |
交付工具(19个)
📁 文件系统(通用)
| 工具 | 说明 |
|---|---|
fs_read_file |
读取行范围—仅读取所需的部分,而不是整个文件 |
fs_search_in_file |
关键字搜索+提取周围上下文 |
fs_list_dir |
目录列表(支持递归/扩展名筛选器) |
fs_write_file |
写入/添加文件 |
🤖 Jarvis机器人
| 工具 | 说明 |
|---|---|
jarvis_status |
检查机器人进程是否运行(Windows/Linux跨平台) |
jarvis_code_outline |
只提取bot.py函数/命令列表(不加载整个文件) |
jarvis_get_command |
仅提取特定命令代码块 |
jarvis_list_packages 检查pip包列表 |
🔬 实验数据(PSpice/Excel)
| 工具 | 说明 |
|---|---|
lab_excel_sheets |
检查Excel工作表列表和大小 |
lab_excel_read |
读取图纸数据(行/列范围) |
lab_excel_summary 数值列统计(min/max/mean) |
|
lab_pspice_parse |
解析PSpice.out文件→提取节点电压/电流/功率 |
🗓️ 元(README变更历史记录)🆕
| 工具 | 说明 |
|---|---|
changelog_add |
在README.md变更历史记录表中添加一行(NEW/FIX/UPDATE/BREAK/DOCS/PERF) |
changelog_view |
查看最新N个README.md变更历史记录 |
🎮 Reversal游戏项目🆕
| 工具 | 说明 |
|---|---|
reversal_read_spec |
从规格文档中按节号读取(例如“4.3”),无需加载1100行 |
reversal_get_state |
查看当前实施阶段+完成项目+最后一个备注 |
reversal_set_state |
阶段更新,添加完成项目,保存工作笔记 |
reversal_read_function |
只提取reversal.html中的特定函数块 |
reversal_replace_function |
在reversal.html中替换特定函数块(自动.bak备份) |
安装
1.构建
npm install
npm run build
2-A.注册Claude Desktop
%APPDATA%\Claude\claude_desktop_config.json 添加到:
{
"mcpServers": {
"dev-assistant": {
"command": "node",
"args": ["C:/path/to/dev-assistant-mcp-server/dist/index.js"]
}
}
}
2-B.Claude Code注册
claude mcp add dev-assistant node /path/to/dev-assistant-mcp-server/dist/index.js
令牌节约示例
前: bot.py 完整文件(500行)→粘贴到上下文
后: jarvis_code_outline →函数列表(20行)→仅需要所需命令 jarvis_get_command
前: 上载Excel文件→加载整个图纸
后: lab_excel_sheets → lab_excel_summary →仅需要行 lab_excel_read
前: REVERSAL-BUILD-SPEC.md(第1114行)完整粘贴
后: reversal_read_spec({ section: "4.3" }) →仅解析算法部分
🚀 构建单个可执行文件(.exe)
无需Node.js即可在任何地方运行 .exe 创建文件。
构建一次
npm run build:exe
# → build/dev-assistant-mcp.exe 생성
Watch Mode(用于开发)
保存源(Ctrl+S)时自动 .exe 重新构建:
npm run watch:exe
# src/ 폴더 감지 → 변경 시 자동 build:exe 실행
.exe 使用时Claude注册:
{
"mcpServers": {
"dev-assistant": {
"command": "C:/path/to/build/dev-assistant-mcp.exe"
}
}
}