JLens MCP Expert Navigation Guide (V1.1.1)

JLens is a Model Context Protocol (MCP) server designed for AI Agents. It provides deep understanding of Java projects through real reflection analysis and bytecode parsing. Unlike simple text search, JLens can identify class inheritance, method signatures, visibility modifiers, and complex Maven dependency topologies.

1. Core Tools and Interaction Details

1.1 Class Inspection (inspect_java_class)

Interaction Logic:

• State Machine Responses:
  • status: "SUCCESS": Parsing successful. Read decompiledSource for logic, and methods/fields for structure.
  • status: "LOCAL_SOURCE": Important! The target class belongs to the current workspace. Ignore metadata and directly read the source code using the read_file tool via the provided sourceFile path.
  • status: "NOT_FOUND": Class does not exist. Check the suggestion field; you might need to run build_module first.
• Key Parameters:
  • bypassCache: If class structure seems outdated (e.g., after recent source changes), set to true to bypass GAV cache for real-time parsing.

1.2 Paginated Search (search_java_class)

Pagination Protocol:

• Result Parsing: If hasMore is true in the response, you must record the nextCursor.
• Subsequent Requests: Pass cursor: "<nextCursor>" in the next call until hasMore is false. Results are sorted by fully qualified name for stability.