java-lsp

← Back to Plugins

Description

Java language server (Eclipse JDT.LS) for code intelligence in GitHub Copilot CLI and Claude Code

Version
1.0.0
Author
Sebastien DEGODEZ
Skills Included
0
lsp java jdtls maven gradle code-intelligence
/plugin marketplace add SebastienDegodez/copilot-instructions /plugin install java-lsp@copilot-instructions-sebastien-degodez

Included Skills

📖 README

☕ java-lsp

Compréhension complÚte des projets Maven et Gradle grùce à Eclipse JDT.LS, le moteur Java de VS Code.

GitHub Copilot CLI Claude Code Agent Plugins Licence

Ce plugin branche le serveur de langage Eclipse JDT Language Server sur votre agent IA. Au lieu de deviner la structure du code par recherche textuelle, l'agent interroge le serveur comme le ferait un IDE : résultats plus précis, plus rapides et moins coûteux en contexte.

✹ Ce que votre agent sait faire avec ce plugin

Capacité Exemple de demande
🎯 Aller Ă  la dĂ©finition « OĂč est dĂ©fini ce symbole ? »
🔎 Trouver les rĂ©fĂ©rences « Qui appelle cette fonction ? »
✏ Renommer un symbole « Renomme cette classe dans tout le projet »
đŸ©ș Diagnostics « Corrige les erreurs signalĂ©es dans ce fichier »
💬 Survol (types, documentation) « Quel est le type de cette variable ? »
đŸ—ș Symboles du document et de l'espace de travail « Liste les classes de ce module »

Les capacités réellement disponibles dépendent de ce que le serveur implémente.

đŸ§© CompatibilitĂ©

Agent Fichier de configuration LSP Format
GitHub Copilot CLI com.github.copilot/lsp.json Agent Plugins 1.0 (plugin.json racine)
Claude Code .lsp.json Plugin Claude Code (.claude-plugin/plugin.json)

Les deux fichiers dĂ©crivent le mĂȘme serveur (jdtls). Ils existent en double car les deux agents n'utilisent pas les mĂȘmes noms de champs (fileExtensions pour Copilot, extensionToLanguage pour Claude).

📋 PrĂ©requis

  • JDK 21+ pour exĂ©cuter le serveur (vos projets peuvent cibler une version plus ancienne)
  • Python 3 (le lanceur jdtls est un script Python)

⚙ 1. Installer le serveur de langage

Le plugin ne contient que la configuration : le serveur doit ĂȘtre installĂ© sur votre machine et accessible dans le PATH.

macOS (Homebrew)

brew install jdtls

Linux / WSL

mkdir -p ~/.local/share/jdtls && \
  curl -fsSL https://download.eclipse.org/jdtls/snapshots/jdt-language-server-latest.tar.gz \
  | tar -xz -C ~/.local/share/jdtls && \
  ln -sf ~/.local/share/jdtls/bin/jdtls ~/.local/bin/jdtls

📩 2. Installer le plugin

GitHub Copilot CLI

copilot plugin marketplace add SebastienDegodez/copilot-instructions
copilot plugin install java-lsp@copilot-instructions-sebastien-degodez

Ou directement, sans passer par la marketplace :

copilot plugin install SebastienDegodez/copilot-instructions:plugins/java-lsp

Claude Code

/plugin marketplace add SebastienDegodez/copilot-instructions
/plugin install java-lsp@copilot-instructions-sebastien-degodez

✅ 3. VĂ©rifier que tout fonctionne

Dans GitHub Copilot CLI :

/lsp list
/lsp test jdtls

Dans Claude Code : ouvrez une nouvelle session dans votre projet, puis demandez par exemple « Trouve toutes les références de maFonction ». En cas de souci, claude --debug affiche les journaux de démarrage du serveur.

đŸ—‚ïž Fichiers pris en charge

Extension Identifiant de langage
.java java

⏱ Ce serveur dĂ©marre lentement : le dĂ©lai est rĂ©glĂ© via startupTimeout (Claude Code) et initializationTimeoutMs (Copilot CLI).

💡 Conseils

  • Le premier dĂ©marrage importe le projet Maven/Gradle et peut ĂȘtre long : le dĂ©lai de dĂ©marrage est portĂ© Ă  2 minutes dans les deux configurations.
  • Lancez mvn compile ou gradle build au moins une fois pour que les dĂ©pendances soient tĂ©lĂ©chargĂ©es.
  • Projet Lombok ? Ajoutez "--jvm-arg=-javaagent:/chemin/vers/lombok.jar" dans args.

đŸ› ïž DĂ©pannage

SymptĂŽme Solution
/lsp test jdtls échoue avec « command not found » Le binaire n'est pas dans le PATH : relancez l'étape 1 et ouvrez un nouveau terminal.
Délai de démarrage dépassé Augmentez startupTimeout (Claude) ou initializationTimeoutMs (Copilot) sur les trÚs gros projets.
Unsupported class file major version Le serveur tourne avec un JDK trop ancien : vérifiez que java -version renvoie 21 ou plus.

Pour désactiver ce serveur dans un dépÎt précis (Copilot CLI), ajoutez dans .github/lsp.json :

{ "lspServers": { "jdtls": { "disabled": true } } }

📁 Structure du plugin

java-lsp/
├── plugin.json                      # Manifeste Agent Plugins 1.0 (Copilot CLI)
├── .claude-plugin/
│   └── plugin.json                  # Manifeste Claude Code
├── .lsp.json                        # Serveur LSP pour Claude Code
├── com.github.copilot/
│   └── lsp.json                     # Serveur LSP pour Copilot CLI
├── plugin.yaml                      # MĂ©tadonnĂ©es du site de documentation
└── README.md

🔗 Liens utiles


Auteur : Sebastien DEGODEZ · Licence : Apache 2.0