Cursor rule

1---
2alwaysApply: true
3---
4 
5# Unreal Project Analyzer - 项目概览
6 
7## 项目愿景
8 
9让 AI 能够完整追踪 Unreal 项目中任意一条引用链，从入口到实现，跨越 Blueprint ↔ C++ ↔ Asset 边界。
10 
11**核心场景**：分析 Lyra 等大型 Unreal 项目，追踪如 GAS Ability 从触发到执行的完整链路。
12 
13## 架构
14 
15```
16AI Agent
17    │ MCP Protocol
18    ▼
19MCP Server (Python/FastMCP)
20    │ - C++ 源码分析 (tree-sitter)
21    │ - 工具路由
22    │ HTTP
23    ▼
24Unreal Plugin (Editor 内运行)
25    ├─ C++ HTTP Server (:8080)
26    │   - Blueprint 内省 API
27    │   - Asset 引用查询 API
28    └─ Python Bridge (自动拉起)
29        - Unreal Python 补充 API
30```
31 
32## 目录结构
33 
34```
35unreal-project-analyzer/           # 主项目目录
36├── Mcp/src/unreal_analyzer/       # MCP Server (Python)
37│   ├── server.py               # 入口
38│   ├── tools/                  # MCP 工具定义
39│   ├── cpp_analyzer/           # C++ 源码分析 (tree-sitter)
40│   └── ue_client/              # UE 插件 HTTP 客户端
41│
42├── Source/                     # Unreal C++ 插件代码
43└── Content/Python/             # Python Bridge
44│
45└── Mcp/tests/                  # 测试
46 
47docs/                           # 项目文档
48reference/                      # 参考项目 (不修改)
49```
50 
51## 关键文件
52 
53- [PROJECT_VISION.md](mdc:docs/PROJECT_VISION.md) - 详细项目愿景和技术规划
54- [server.py](mdc:Mcp/src/unreal_analyzer/server.py) - MCP Server 入口
55- [UnrealProjectAnalyzer.cpp](mdc:Source/UnrealProjectAnalyzer/Private/UnrealProjectAnalyzer.cpp) - Unreal 插件入口
56 
57## 技术栈
58 
59| 组件 | 技术选型 |
60|------|----------|
61| Python 包管理 | uv |
62| MCP 框架 | FastMCP |
63| C++ 解析 | tree-sitter + tree-sitter-cpp |
64| UE 通信 | HTTP (自研插件) |
65| UE 版本 | 5.3+ |
66 
67## 当前版本：v0.3.1
68 
69**8 个工具**（4 核心 + 4 特殊）：
70 
71| 核心工具 | 特殊工具 |
72|----------|----------|
73| `search` | `get_blueprint_graph` |
74| `get_hierarchy` | `detect_ue_patterns` |
75| `get_references` | `trace_reference_chain` |
76| `get_details` | `find_cpp_class_usage` |
77 
78详见 [mcp-tools-design.mdc](mdc:.cursor/rules/mcp-tools-design.mdc)
79