Cursor rule

1---
2description: Project context and technology stack overview
3globs: ["**/*.py", "**/*.md"]
4alwaysApply: false
5---
6 
7# Project Context
8 
9## Project Overview
10 
11You are an expert Python developer working on a production-grade MCP (Model Context Protocol) server for UniFi Network Controller integration. This server enables AI agents to manage UniFi network infrastructure through 40+ standardized tools.
12 
13## AI Assistant Guidelines
14 
15- Project-specific guidance for AI coding assistants is in `CLAUDE.md` and `AGENTS.md`
16- Follow the development workflow and coding standards documented in these files
17- Maintain consistency across all AI-assisted development
18 
19## Technology Stack
20 
21**Core Technologies:**
22- Python 3.10+ with type hints and async/await patterns
23- FastMCP framework for MCP server implementation
24- Pydantic for data validation and schema generation
25- Redis for optional caching layer
26- pytest for testing (target 80%+ coverage)
27- Pre-commit hooks: black, isort, ruff, mypy, bandit
28 
29**Architecture:**
30- Async-first design for high concurrency
31- Tool-based API (40+ MCP tools across devices, networks, clients, firewall, WiFi, DPI)
32- Resource endpoints for read-only data access
33- Optional Redis caching with automatic invalidation
34- Webhook support for real-time event handling
35- Multi-site UniFi controller support
36 
37## Project Structure
38 
39```
40unifi-mcp-server/
41├── src/
42│   ├── main.py              # MCP server registration and entry point
43│   ├── api/                 # UniFi API client with rate limiting
44│   ├── tools/               # MCP tool implementations (grouped by domain)
45│   ├── resources/           # MCP resource definitions
46│   ├── webhooks/            # Event handlers
47│   ├── config/              # Configuration management
48│   ├── utils/               # Validators, formatters, helpers
49│   └── cache.py             # Redis caching implementation
50├── tests/
51│   ├── unit/                # Fast, isolated tests with mocks
52│   └── integration/         # Tests requiring UniFi controller
53├── docs/
54│   └── AI-Coding/           # AI coding guidelines
55├── .env.example             # Environment variable template
56└── pyproject.toml           # Dependencies and project config
57```
58 
59## File Naming Conventions
60 
61- **Python files:** Use `snake_case` (e.g., `device_manager.py`)
62- **Classes:** Use `PascalCase` (e.g., `UniFiClient`)
63- **Functions/variables:** Use `snake_case` (e.g., `get_devices()`)
64- **Constants:** Use `UPPER_SNAKE_CASE` (e.g., `DEFAULT_TIMEOUT`)
65- **Test files:** Prefix with `test_` (e.g., `test_device_manager.py`)
66 
67## Version
68 
69**UniFi MCP Server v0.1.2**
70Python 3.10+ | FastMCP | Async-first Architecture
71