jons-mcp-java

Instructions

Implementation Reference

• src/jons_mcp_java/tools/symbols.py:13-49 (handler)

  The primary handler function implementing the 'document_symbols' tool logic. It uses the JDT.LS client manager to get the appropriate LSP client, sends a documentSymbol request, formats the response, and returns the symbols.
  @mcp.tool() async def document_symbols( file_path: str, ) -> dict: """ Get all symbols defined in a Java file. Args: file_path: Absolute path to the Java file Returns: Dictionary with 'symbols' array or 'status'/'message' if initializing """ manager = get_manager() if manager is None: return {"status": "error", "message": "Server not initialized"} client, status = await manager.get_client_for_file_with_status(Path(file_path)) if client is None: return {"status": "initializing", "message": status} await client.ensure_file_open(file_path) response = await client.request( LSP_TEXT_DOCUMENT_DOCUMENT_SYMBOL, { "textDocument": {"uri": path_to_uri(file_path)}, } ) if response is None: return {"symbols": []} # Response is either DocumentSymbol[] or SymbolInformation[] symbols = [format_symbol(sym) for sym in response] return {"symbols": symbols}
• src/jons_mcp_java/server.py:65-65 (registration)

  Import statement in the main server file that loads the symbols module, thereby registering the 'document_symbols' tool via FastMCP's decorator system (@mcp.tool()).
  from jons_mcp_java.tools import navigation, symbols, diagnostics, info # noqa: E402, F401
• src/jons_mcp_java/tools/__init__.py:18-18 (registration)

  The 'document_symbols' tool is listed in the __all__ export list of the tools package, facilitating its import and registration.
  "document_symbols",
• src/jons_mcp_java/tools/symbols.py:10-10 (helper)

  Imports helper functions used in the document_symbols handler: format_symbol to process LSP symbols and path_to_uri for URI conversion.
  from jons_mcp_java.utils import format_symbol, path_to_uri