开发辅助MCP服务器

用于优化AI代理开发过程中令牌使用的多用途开发辅助工具,支持文件系统操作、调试工具和实验数据处理等功能。

  • by hapew112
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 hapew112/My_mcp-server

使用说明

开发助理mcp服务器

用于令牌优化的通用开发辅助MCP服务器。
不要将整个文件粘贴到Claude上下文中,而是只查询所需的部分以减少令牌的使用。


🛡️ 工程标准:手术调试与策略

使用此MCP服务器的所有AI代理 五阶段工程标准必须严格遵守。这是为了用最少的令牌确保最大的精度。

  1. 查看现象(Observe Symptoms First)

    • 在修改代码之前, jarvis_status通过日志文件等收集真实证据(Raw Evidence)。
    • 不仅根据假设进行编码,必须在确认实际状态后开始工作。
  2. 原因反向追踪(Root Cause Tracing)

    • 从症状开始 fs_search_in_file 等,追溯代码,查找根本原因。
    • Input → Processing → Output标识在的流中发生错误的最前面的点。
  3. 依赖关系排序(Dependency Ordering)

    • 如果有多个问题,请按依赖性顺序排序。
    • 问“如果不修复A,是否可以测试B?”以确定先行任务。
  4. 精确修改(Surgical Precision)

    • fs_read_file只读取所需的部分,修改正确的文件路径和代码块,不含糊。
    • 修改后必须经过验证。
  5. 以目标为中心的设计(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"
    }
  }
}