diff --git a/.cursor/mcp.json b/.cursor/mcp.json
index 52575c0c..af007fe2 100644
--- a/.cursor/mcp.json
+++ b/.cursor/mcp.json
@@ -25,6 +25,21 @@
             "env": {
                 "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_TOKEN_HERE"
             }
+        },
+        "serena": {
+            "command": "docker",
+            "args": [
+                "run",
+                "-i",
+                "--rm",
+                "-v",
+                ".:/workspaces/projects/repo",
+                "ghcr.io/oraios/serena:latest",
+                "serena",
+                "start-mcp-server",
+                "--project",
+                "/workspaces/projects/repo"
+            ]
         }
     }
 }
diff --git a/.serena/.gitignore b/.serena/.gitignore
new file mode 100644
index 00000000..4fa99cf8
--- /dev/null
+++ b/.serena/.gitignore
@@ -0,0 +1,4 @@
+/cache
+/project.local.yml
+/memories
+
diff --git a/.serena/project.yml b/.serena/project.yml
new file mode 100644
index 00000000..30bf9cee
--- /dev/null
+++ b/.serena/project.yml
@@ -0,0 +1,40 @@
+# Serena project config — Java (LSP) for this repo
+# Docs: https://oraios.github.io/serena/
+
+project_name: "cursor-rules-java"
+
+languages:
+  - java
+
+ignore_all_files_in_gitignore: true
+
+ignored_paths: []
+
+read_only: false
+
+excluded_tools: []
+
+included_optional_tools: []
+
+initial_prompt: |
+  Read the repository root AGENTS.md for project role, tech stack, layout, commands, Git workflow, and boundaries before making changes.
+
+encoding: utf-8
+
+base_modes:
+
+default_modes:
+
+fixed_tools: []
+
+symbol_info_budget:
+
+language_backend:
+
+read_only_memory_patterns: []
+
+line_ending:
+
+ignored_memory_patterns: []
+
+ls_specific_settings: {}