cursorrules

Suno-MCP Cursor Rulebook

🚨 CRITICAL REQUIREMENTS

PowerShell Syntax (MANDATORY)

• NEVER use Linux/Unix commands - Only Windows PowerShell commands
• NEVER use && - Use separate PowerShell commands
• NEVER use cd /d - Use Set-Location or cd
• NEVER use rmdir /s /q - Use Remove-Item -Recurse -Force
• NEVER use mkdir - Use New-Item -ItemType Directory
• NEVER use cp or mv - Use Copy-Item and Move-Item
• ALWAYS use PowerShell cmdlets - Get-ChildItem, Set-Content, etc.

Command Examples (CORRECT):

✅ Set-Location "D:\path\to\dir"
✅ New-Item -ItemType Directory -Path "folder"
✅ Remove-Item -Recurse -Force "path"
✅ Copy-Item "source" "destination"
✅ Get-ChildItem -Recurse

Command Examples (WRONG):

❌ cd /d D:\path\to\dir
❌ mkdir folder
❌ rmdir /s /q path
❌ cp source destination
❌ find . -name "*.py"
❌ command1 && command2

🔧 FastMCP Standards (MANDATORY)

Tool Registration

• ALWAYS use @mcp_app.tool() decorators
• ALWAYS provide comprehensive docstrings with Args/Returns
• NEVER use multiline docstrings with """ inside
• ALWAYS follow FastMCP 2.12 standards

Tool Documentation Format:

@mcp_app.tool()
async def tool_name(param: str) -> str:
    """
    Brief description of what the tool does.

    More detailed explanation if needed.

    Args:
        param: Description of the parameter

    Returns:
        Description of the return value
    """

Server Structure

• ALWAYS use FastMCP FastAPI integration
• ALWAYS provide dual interface (stdio + HTTP)
• ALWAYS use proper error handling with custom exceptions
• ALWAYS implement comprehensive logging

🐍 Python Standards

Code Style

• ALWAYS use type hints for function parameters and returns
• ALWAYS use async/await for I/O operations
• ALWAYS use descriptive variable names
• NEVER use bare except: - Always catch specific exceptions
• ALWAYS use context managers for resource management