---

name: serena category: integration-connectivity/mcp-integrations version: 1.0.0 description: Complete guide to using Serena MCP server for AI-powered code analysis with Claude Code author: blackbox5/mcp verified: true tags: [mcp, serena, code-analysis, review, security]

Serena MCP Server Skills

Type: STDIO (local) Command: npx with Serena package

Capabilities:

• Code Quality Analysis - Identifies potential issues and bugs
• Performance Optimization - Suggests performance improvements
• Security Scanning - Detects security vulnerabilities
• Best Practices - Enforces coding standards
• Refactoring Suggestions - Recommends code improvements
• Documentation Generation - Auto-generates code documentation

Provide context about the code being analyzed and specify focus areas (security, performance, bugs, etc.) for better results.

<available_skills> <skill_group name="Code Analysis"> Analyze code for quality, bugs, and improvements Analyze src/components/Header.tsx for bugs Path to file to analyze Specific focus area (security, performance, bugs, etc.) Identified issues, severity levels, suggestions for fixes, best practice violations Get detailed explanation of code functionality Explain how this function works Code breakdown, algorithm explanation, data flow analysis, dependency mapping Perform comprehensive code review Review changes in src/lib/auth.ts Path to review Only review changed lines (for PRs) Code quality assessment, security concerns, performance issues, style guide violations, improvement suggestions </skill_group>

<skill_group name="Code Optimization"> Analyze and optimize code performance Find performance bottlenecks in my code Performance bottlenecks, optimization opportunities, caching suggestions, algorithm improvements Suggest refactoring improvements Refactor this component to be more maintainable Structural improvements, design pattern suggestions, code organization tips, simplification opportunities </skill_group>

<skill_group name="Security Analysis"> Scan code for security vulnerabilities Scan for security issues Security vulnerabilities, common attack vectors, OWASP top 10 issues, remediation steps Detect exposed secrets and credentials Check for exposed API keys Found secrets/credentials, location in code, severity level, recommendations </skill_group>

<skill_group name="Documentation"> Generate code documentation Generate documentation for this function Function documentation, parameter descriptions, return value docs, usage examples Explain error messages and suggest fixes Explain this TypeScript error Error message or code Surrounding code Error explanation, root cause analysis, fix suggestions, prevention tips </skill_group>

<skill_group name="Code Generation"> Generate unit tests for code Create test cases for my component Test file content, test cases, mock setup, assertions Get general improvement suggestions Suggest modern JavaScript alternatives Modern language features, library alternatives, pattern improvements, best practice recommendations </skill_group> </available_skills>

<best_practices> Run Serena before committing Address high-severity issues Consider all suggestions Ask for clarification Use for learning Be specific with requests Provide relevant code context Ask for explanations Iterate and re-review Ignore security warnings Blindly accept all changes Forget to test suggestions Skip code review Rely solely on automation Use vague requests </best_practices>

<error_handling> Serena not responding Check if MCP server is running Verify Serena package is installed Restart Claude instance Generic suggestions Provide more context Specify focus area Ask for specific issues Performance slow Analyze smaller code chunks Focus on specific files Use targeted analysis </error_handling>

<integration_notes> Code Analysis Security Scanning Performance Optimization Testing Performance Browser DevTools Performance Use Serena for code analysis, Playwright for testing, Chrome DevTools for browser debugging </integration_notes>

<integration_notes> Lumelle Review React components for best practices Optimize component performance Check for security issues in auth code Review Supabase queries Optimize database access Check for SQL injection risks Review API endpoints Check error handling Optimize response time </integration_notes>

<advanced_usage> Custom Rules Serena can be configured with custom rules for your project Enforce Lumelle coding standards Check for specific patterns Custom security rules CI/CD Integration Run Serena in GitHub Actions Block merge on critical issues Generate reports Team Collaboration Share Serena reviews Comment on suggestions Track issue resolution </advanced_usage>