feat: add analyze_project MCP tool for project-aware answers

Reads a Unity project from disk (no running editor needed) and reports
the editor version, the render pipeline in use, notable packages, active
input handling, scripting backend, API compatibility, scripting define
symbols, and assembly definitions.

The pipeline is resolved from the asset assigned in GraphicsSettings or
per quality level in QualitySettings, matched by GUID to its .meta file
and identified by the URP/HDRP pipeline asset script GUIDs (taken from
the 6000.0 package sources), with package-based fallbacks and a note
when an SRP is installed but unassigned. Field layouts were checked
against public Unity 6 projects, and the tool was run against Unity's
game-programming-patterns-demo (6000.0.9f1, URP per quality level).

The render-pipeline-detection, input-systems, and platform-targeting
skills now tell the agent to call analyze_project first. Docs and tool
counts updated to 5 tools.

Closes #38

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MpEiWjv38TrdFcgqU8ER5L

Author: TMHSDigital

.cursorrules

@@ -7,7 +7,7 @@ You are working on Unity Developer Tools, a Cursor IDE plugin for Unity game dev
 - `rules/` - 8 .mdc rule files (C# conventions, lifecycle, performance, naming, serialization, shaders, visual scripting, security)
 - `snippets/` - 20 code snippets organized by type (csharp, shaders, visual-scripting)
 - `templates/` - 5 starter templates (2d-platformer, 3d-fps, ui-menu-system, scriptableobject-architecture, editor-tool)
-- `mcp-server/` - Python FastMCP server with 4 tools and JSON data files
+- `mcp-server/` - Python FastMCP server with 5 tools and JSON data files
 - `docs/` - architecture, roadmap, contributing, getting started
 - `.github/workflows/` - validate, release, deploy-docs, label-sync, update-unity-api, stale
 - `mkdocs.yml` - MkDocs Material documentation site configuration

AGENTS.md

@@ -13,7 +13,7 @@ This is a Cursor IDE plugin for Unity game development. It contains:
 - **`rules/`** - 8 .mdc rule files enforcing coding conventions
 - **`snippets/`** - 20 code snippet files (C#, shaders, visual scripting guide)
 - **`templates/`** - 5 starter project templates (2D platformer, 3D FPS, UI menu, SO architecture, editor tool)
-- **`mcp-server/`** - Python MCP server with 4 tools and JSON data files
+- **`mcp-server/`** - Python MCP server with 5 tools and JSON data files
 - **`docs/`** - ARCHITECTURE.md, ROADMAP.md, CONTRIBUTING.md, GETTING-STARTED.md
 - **`CHANGELOG.md`** - manually maintained release history
 - **`.github/workflows/`** - CI/CD automation
@@ -153,7 +153,7 @@ The MCP server is registered by the plugin in `mcp.json` (referenced from `.curs
 - ECS/DOTS is now a core engine package (Entities 1.4+), not experimental.
 - FindObjectOfType is deprecated; use FindFirstObjectByType.
 - CGPROGRAM is deprecated; use HLSLPROGRAM for URP/HDRP shaders.
-- The MCP server uses Python FastMCP with 4 tools and 5 JSON data files.
+- The MCP server uses Python FastMCP with 5 tools and 5 JSON data files.
 
 ## License
 

CLAUDE.md

@@ -6,7 +6,7 @@ Project documentation for Claude Code and AI assistants working on this reposito
 
 ## Project Overview
 
-Unity Developer Tools is a Cursor IDE plugin for Unity game development. It includes 18 skills, 8 rules, 20 code snippets across C# / HLSL / Visual Scripting, 5 starter templates, and a companion Python MCP server with 4 tools for script scaffolding, Unity API lookup, shader patterns, and platform information.
+Unity Developer Tools is a Cursor IDE plugin for Unity game development. It includes 18 skills, 8 rules, 20 code snippets across C# / HLSL / Visual Scripting, 5 starter templates, and a companion Python MCP server with 5 tools for script scaffolding, Unity API lookup, shader patterns, platform information, and project analysis.
 
 **Works with:** Cursor (plugin), Claude Code (terminal and in-editor), and any MCP-compatible client.
 
@@ -77,7 +77,7 @@ Unity-Developer-Tools/
 | `visual-scripting-conventions.mdc` | `**/*.asset` | Best practices for Unity Visual Scripting graphs |
 | `security-and-builds.mdc` | `**/*.cs`, `**/*.json`, `**/*.asset` | Security and build configuration rules (no hardcoded secrets, build target hygiene) |
 
-## MCP Server (4 tools)
+## MCP Server (5 tools)
 
 The companion MCP server is Python-based (FastMCP). It exposes Unity-aware tools that read from local data files (`mcp-server/data/`) and accept agent-supplied parameters.
 
@@ -87,6 +87,7 @@ The companion MCP server is Python-based (FastMCP). It exposes Unity-aware tools
 | `lookup_api` | Search the Unity API reference (name, namespace, signature, examples) with optional category filter and deprecated-pattern warnings |
 | `shader_helper` | Fetch shader patterns and property setups for common effects (dissolve, outline, toon, water, hologram, fresnel) per render pipeline |
 | `platform_info` | Get platform-specific scripting defines, capabilities, limitations, and recommendations (Windows, macOS, Linux, Android, iOS, WebGL, PS5, Xbox, Switch) |
+| `analyze_project` | Read a Unity project from disk (editor version, render pipeline, packages, input handling, scripting backend, define symbols, asmdefs) so advice matches the actual project |
 
 ## Development Workflow
 

README.md

@@ -29,7 +29,7 @@
 ---
 
 <p align="center">
-  18 skills &nbsp;&bull;&nbsp; 8 rules &nbsp;&bull;&nbsp; 4 MCP tools &nbsp;&bull;&nbsp; 20 snippets &nbsp;&bull;&nbsp; 5 templates
+  18 skills &nbsp;&bull;&nbsp; 8 rules &nbsp;&bull;&nbsp; 5 MCP tools &nbsp;&bull;&nbsp; 20 snippets &nbsp;&bull;&nbsp; 5 templates
 </p>
 
 Scaffold Unity scripts, look up APIs, generate shader patterns, detect render pipelines, and write optimized C# -- all from within Cursor's AI chat. Covers the full Unity development lifecycle from project setup to platform deployment.
@@ -46,7 +46,7 @@ Scaffold Unity scripts, look up APIs, generate shader patterns, detect render pi
 flowchart LR
     A["You ask Cursor\na Unity question"] --> B["Cursor loads\na Skill"]
     B --> C{"MCP server\navailable?"}
-    C -- Yes --> D["Unity MCP Server\n(4 tools)"]
+    C -- Yes --> D["Unity MCP Server\n(5 tools)"]
     C -- No --> E["Skill guidance\nonly"]
     D --> F["Scaffold, lookup,\nshader help,\nplatform info"]
     E --> G["AI-assisted answer\nin Cursor chat"]
@@ -235,7 +235,7 @@ python -m pip install -r ~/.cursor/plugins/local/unity-developer-tools/mcp-serve
 Cursor starts the server automatically. Other MCP clients can run `python <plugin folder>/mcp-server/server.py` over stdio.
 
 <details>
-<summary><strong>Available Tools (4)</strong></summary>
+<summary><strong>Available Tools (5)</strong></summary>
 
 &nbsp;
 
@@ -245,6 +245,7 @@ Cursor starts the server automatically. Other MCP clients can run `python <plugi
 | `lookup_api` | Search the Unity API reference database by name, namespace, or category. Returns signatures, descriptions, and examples. |
 | `shader_helper` | Get shader code patterns for common effects (dissolve, outline, hologram, etc.) with HLSL and Shader Graph guidance. |
 | `platform_info` | Get platform-specific defines, capabilities, limitations, and build recommendations. |
+| `analyze_project` | Read a Unity project's editor version, render pipeline, packages, input handling, scripting backend, define symbols, and assembly definitions. Unity does not need to be running. |
 
 </details>
 
@@ -285,7 +286,7 @@ Unity-Developer-Tools/
   rules/               Coding convention rules (8 rules)
   snippets/            Code snippets -- C#, shaders (20 files)
   templates/           Starter project templates (5 sets)
-  mcp-server/          Python MCP server (4 tools) and data files
+  mcp-server/          Python MCP server (5 tools) and data files
   docs/                Architecture, roadmap, contributing guide
   assets/              Logo and images
   .github/             CI/CD workflows (5 workflows)

docs/ARCHITECTURE.md

@@ -46,11 +46,12 @@ Complete starter project scaffolds. Each template is a self-contained directory
 
 ### MCP Server (mcp-server/)
 
-A Python FastAPI server implementing the Model Context Protocol. Provides 4 tools:
+A Python FastMCP server implementing the Model Context Protocol. Provides 5 tools:
 - `scaffold_script` - Generate scripts from templates
 - `lookup_api` - Search Unity API reference data
 - `shader_helper` - Get shader effect patterns
 - `platform_info` - Get platform-specific information
+- `analyze_project` - Read a Unity project's version, render pipeline, packages, and settings from disk
 
 Data files in `mcp-server/data/` provide the reference databases:
 - `unity_api_common.json` - Common Unity API entries

docs/index.md

@@ -2,7 +2,7 @@
 
 **AI-powered development toolkit for Unity game development in Cursor IDE.**
 
-18 skills -- 8 rules -- 4 MCP tools -- 20 snippets -- 5 templates
+18 skills -- 8 rules -- 5 MCP tools -- 20 snippets -- 5 templates
 
 ---
 
@@ -62,7 +62,7 @@ For a detailed walkthrough, see the [Getting Started guide](GETTING-STARTED.md).
 flowchart LR
     A["You ask Cursor\na Unity question"] --> B["Cursor loads\na Skill"]
     B --> C{"MCP server\navailable?"}
-    C -- Yes --> D["Unity MCP Server\n(4 tools)"]
+    C -- Yes --> D["Unity MCP Server\n(5 tools)"]
     C -- No --> E["Skill guidance\nonly"]
     D --> F["Scaffold, lookup,\nshader help,\nplatform info"]
     E --> G["AI-assisted answer\nin Cursor chat"]

mcp-server/README.md

@@ -25,6 +25,12 @@ Get shader code patterns and property setups for common effects. Hand-written HL
 Get platform-specific scripting defines, capabilities, and build recommendations.
 - **platform**: Target platform (windows, macos, linux, android, ios, webgl, ps5, xbox, switch)
 
+### analyze_project
+Summarize a Unity project from its files, without Unity running: editor version, render pipeline (resolved from the pipeline asset assigned in Graphics or Quality settings), notable packages, active input handling, scripting backend, API compatibility, scripting define symbols, and assembly definitions.
+- **project_path**: Path to the Unity project root (contains `Assets/`, `Packages/`, `ProjectSettings/`)
+
+Settings must use text serialization (the Unity default, **Force Text**) for full detection.
+
 ## Running
 
 The plugin registers the server in `mcp.json` at the plugin root, and Cursor starts it automatically once the plugin is installed.