性能分析器 MCP 服务器 v3.0
CyberZ Client 是用于 DirectX 12 项目的综合性能分析工具。
主要功能
🆕 v3.0 新功能
- 项目源代码分析直接分析CyberZ Client项目的C++源代码
- 自动性能评估基于代码模式估计渲染复杂度和内存使用量
- 优化建议提供针对代码层面发现的潜在瓶颈的具体建议
现有功能
- FPS分析（平均值，最小/最大值，百分位数，帧稳定性）
- 内存分析（使用量、泄漏检测、详细内存追踪）
- 渲染分析（绘制调用、三角形数量、GPU/CPU时间）
- 瓶颈现象检测及建议事项
- 生成综合性能报告（分数及等级）
- 会话间对比分析
安装
cd C:\Users\jinsu\Desktop\Portfolio\project\AI\performance_pofiler_mcp
npm install
npm run build使用方法
在Claude Desktop中使用
claude_desktop_config.json 在文件中添加以下内容：
{
"mcpServers": {
"performance-profiler": {
"command": "node",
"args": [
"C:\\Users\\jinsu\\Desktop\\Portfolio\\project\\AI\\performance_pofiler_mcp\\dist\\index.js"
]
}
}
}工具列表（11个）
1. 分析网络空间项目（或：网络项目分析）
对CyberZ Client项目的源代码进行全面分析。
// 기본 경로 사용
analyze_cyberz_project()
// 특정 경로 지정
analyze_cyberz_project({
projectPath: "C:\\path\\to\\project"
})分析内容：
- 项目文件结构（源代码、头文件、着色器、资源）
- 主要源文件的渲染调用模式
- 内存分配/释放模式
- 同步工作及潜在瓶颈
- 预期的Draw Call数量及内存使用量
- 渲染复杂度（低/中/高/非常高）
- 优化水平评估（差/一般/好/优秀）
输出示例：
🎮 CyberZ Client 프로젝트 분석 결과
📁 프로젝트 경로: C:\...\Client
📊 파일 구조:
- 소스 파일: 45개
- 헤더 파일: 48개
- 셰이더: 2개
- 모델: 120개
- 텍스처: 350개
- 오디오: 12개
🎯 예상 성능:
- Draw Calls: ~850
- 메모리 사용: ~1200 MB
- 렌더링 복잡도: Medium
- 최적화 수준: Good
💡 권장사항:
- 텍스처가 많습니다. 텍스처 아틀라스나 스트리밍을 고려하세요
- 코드가 잘 최적화되어 있습니다!2. 获取项目结构
仅快速查看项目文件结构。
3. 分析源文件
对特定源文件进行详细分析。
analyze_source_file({
filePath: "C:\\...\\GameFramework.cpp"
})分析项目：
- Draw Call 模式
- PSO（流水线状态对象）变更频率
- 描述符堆设置
- 内存分配/释放平衡
- 同步工作
- 未优化的循环
4-11。 现有工具
analyze_fpsFPS数据分析parse_memory内存数据解析analyze_memory内存使用分析parse_render渲染数据解析analyze_render渲染性能分析detect_bottleneck瓶颈现象检测generate_report生成综合报告compare_sessions会话比较
使用示例
1. 项目整体分析
Claude에게 물어보세요:
"CyberZ Client 프로젝트를 분석해줘"
"프로젝트의 성능 병목 현상을 찾아줘"
"코드 최적화가 필요한 부분을 알려줘"2. 特定文件分析
"GameFramework.cpp 파일의 렌더링 성능을 분석해줘"
"Shader.cpp에서 PSO 변경이 얼마나 자주 일어나는지 확인해줘"3. 实时数据分析
"이 FPS 데이터를 분석해줘"
"메모리 누수가 있는지 확인해줘"
"현재 병목 현상의 원인을 찾아줘"分析目标文件
以下主要源文件将被基本分析：
GameFramework.cpp游戏框架及渲染循环Shader.cpp着色器管理及PSO（预着色状态对象）Scene.cpp场景管理及对象渲染Object.cpp对象渲染和更新Mesh.cpp消息渲染Player.cpp与玩家相关的逻辑
性能指标
渲染复杂度
- 低绘制调用 \ 3000
优化水平
- 优秀潜在瓶颈 \ 20个
潜在瓶颈检测模式
服务器会自动检测以下模式：
- 过度的PSO更改> 100集
- 频繁的描述符堆设置> 200次
- 同步工作GPU等待及使用栅栏
- 内存不平衡分配 > 释放 * 1.5
- 未优化的循环# 没有#pragma omp的循环
建议事项示例
根据分析结果，我们提供以下具体建议：
- 为了减少管线状态对象的变更，请考虑材质批处理
- Draw Call 很多。考虑使用实例化或间接绘制。
- 使用纹理图集来优化纹理绑定
- GPU同步操作很多。考虑改为异步处理。
- 检测到内存泄漏。请检查资源释放逻辑。
开发模式
# TypeScript 파일 수정 시 자동 빌드
npm run watch
# 서버 직접 실행
npm start版本历史
v3.0.0（2025年10月）
- ✨ CyberZ Client 项目添加源代码分析功能
- 🔍 自动性能评估与预测功能
- 💡 代码层级优化建议
- 新增3个工具（共11个）
v2.0.0（版本2.0.0）
- 8个性能分析工具
- FPS、内存、渲染分析
- 瓶颈检测及报告生成
v1.0.0
- 初期发布
许可证
ISC（Internet Service Center，互联网服务中心）