Skip to content
Back to search

easy-code-reader

A powerful MCP server for intelligently reading Jar source code.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/fangyuan33--easy-code-reader/badge.svg)](/listings/fangyuan33--easy-code-reader)

HTML

<a href="/listings/fangyuan33--easy-code-reader"><img src="/api/listings/fangyuan33--easy-code-reader/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 469 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Easy Code Reader
  2. <div align="center">
  3. <img src="https://raw.githubusercontent.com/FangYuan33/easy-code-reader/master/icon.png" alt="Easy Code Reader Icon" width="200"/>
  4. </div>
  5. <div align="center">
  6. 一个强大的本地 MCP Server,用于智能读取 Java 源代码。支持从 Maven 依赖(JAR 包)中提取源码,配备双反编译器(CFR/Fernflower)自动选择机制,智能处理 SNAPSHOT 版本,让 AI 助手能够深入理解你的 Java 代码库。
  7. A powerful MCP (Model Context Protocol) server for intelligently reading Java source code. Supports extracting source code from Maven dependencies, equipped with dual decompiler (CFR/Fernflower) auto-selection mechanism and intelligent SNAPSHOT version handling. Empowers AI assistants to deeply understand your Java codebase.
  8. </div>
  9. ---
  10. ## 功能特性
  11. - 🤖 **AI 友好的智能提示**:所有工具都具备智能错误提示机制,当查询失败时主动引导 AI 助手调整策略,有效减少幻觉和重复尝试
  12. - 📦 **从 Maven 仓库读取源代码**:自动从本地 Maven 仓库(支持启动参数、`MAVEN_REPO` 和 Maven settings 配置)中查找和读取 JAR 包源代码
  13. - 🔍 **源码读取**:优先从 sources JAR 提取源码,其次复用磁盘缓存,缓存不可用时反编译原始 JAR
  14. - 🛠️ **双反编译器支持**:根据运行时 Java 版本选择 CFR 或 Fernflower,失败时尝试兼容的备用反编译器
  15. - ⚡ **智能缓存机制**:反编译结果保存在 Maven 版本目录,SNAPSHOT 使用最新时间戳包名管理缓存,校验实际输入包的大小与修改时间
  16. - 🔄 **SNAPSHOT 支持**:普通 SNAPSHOT 主包优先读取,最新时间戳包名用于管理缓存
  17. - 📄 **按行读取**:默认返回全文,也可通过 `start_line`、`end_line` 指定阅读范围
  18. ## 最佳实践
  19. Easy Code Reader 特别适合与 Claude、ChatGPT 等大模型配合使用,接下来以 VSCode 结合 Copilot 为例,介绍一些最佳实践:
  20. ### 阅读 jar 包源码,根据源码完成代码编写
  21. 在使用第三方依赖时,可以让 AI 助手通过 MCP 获取指定版本的源码,结合真实实现进行分析。在 Easy Code Reader 中提供了 `read_jar_source` 工具来读取 jar 包中的源码,帮我们完成开发实现。以下面代码为例,现在我想实现多个服务实例的注册,但是我又不了解 `NamingService` 的实现,便可以借助 `read_jar_source` 来完成:
  22. ```java
  23. public class Main {
  24. private static final Logger logger = LoggerFactory.getLogger(Main.class);
  25. public static void main(String[] args) throws NacosException, InterruptedException {
  26. logger.info("开始初始化 Nacos 客户端...");
  27. Properties properties = new Properties();
  28. properties.put(PropertyKeyConst.SERVER_ADDR, "127.0.0.1:8848");
  29. properties.put(PropertyKeyConst.NAMESPACE, "7430d8fe-99ce-4b20-866e-ed021a0652c9");
  30. NamingService namingService = NacosFactory.createNamingService(properties);
  31. System.out.println("=== 注册服务实例 ===");
  32. try {
  33. // 注册一个服务实例
  34. namingService.registerInstance("test-service0", "127.0.0.1", 8080);
  35. // 添加事件监听器
  36. namingService.subscribe("test-service", event -> {
  37. System.out.println("服务实例变化: " + event);
  38. });
  39. // 注册多个服务实例
  40. } catch (Exception e) {
  41. System.out.println("服务注册失败(预期,因为服务器可能未启动): " + e.getMessage());
  42. }
  43. TimeUnit.HOURS.sleep(3);
  44. }
  45. }
  46. ```
  47. ```text
  48. 你是一位 Java 技术专家,精通 Nacos 框架,请你帮我在 #file:Main.java 中完成注册多个服务实例的逻辑,在编写代码前,你需要先使用 easy-code-reader 的 read_jar_source 工具读取 com.alibaba.nacos.api.naming.NamingService 的源码信息来了解注册多个服务实例的方法
  49. ```
  50. 处理过程如下所示:
  51. ![img.png](https://raw.githubusercontent.com/FangYuan33/easy-code-reader/master/imges/img3.png)
  52. 这样我们便能够快速地了解 `NamingService` 的实现细节,从而完成代码编写工作,节省了大量时间。
  53. 还可以使用 Easy Code Reader 完成以下事项:
  54. - 异常问题快速溯源:如果有异常信息是外部 jar 包依赖中抛出来的,可以使用 `read_jar_source` 工具根据异常堆栈日志快速定位异常点
  55. - 依赖升级影响评估(旧/新版本差异核对):同样是使用 `read_jar_source` 工具来完成新旧版本的实现差异,评估升级影响
  56. ---
  57. <a id="quick-start-env"></a>
  58. ## 环境要求
  59. - Python 3.10 或更高版本。
  60. - [uv](https://github.com/astral-sh/uv):用于下文的安装和运行命令。
  61. - Java:生成反编译结果时需要 `java` 在 PATH 中,建议使用 JDK 11 或 21。直接读取 sources JAR 或有效缓存时无需启动 Java。
  62. - 运行自动测试需要 `javac`,测试脚本使用 `javac --release 8`;建议同样使用 JDK 11 或 21。
  63. - 使用 Inspector 浏览器调试时,需要 Node.js 22.19.0 或更高版本及 `npx`。
  64. ## 快速接入(方法一):使用 uvx(推荐)
  65. 以下两种接入方式运行包源中的已发布版本。调试当前仓库代码请使用[本地开发与验证](#local-development)和 [Inspector 调试](#inspector-debugging)。
  66. 如果您还没有安装 uv,可以通过以下方式快速安装:
  67. ```bash
  68. # macOS/Linux
  69. curl -LsSf https://astral.sh/uv/install.sh | sh
  70. # Windows
  71. powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
  72. ```
  73. 或者参考 [uv 官网](https://github.com/astral-sh/uv) 进行安装,并配置 uv 的安装路径添加到系统 PATH 中,以便可以直接使用 `uvx` 命令。[uv](https://github.com/astral-sh/uv) 是一个极快的 Python 包和项目管理工具。使用 `uvx` 可以无需预先安装,直接运行,使用 `mcpServers` JSON 配置格式的客户端可参考以下示例:
  74. - `--maven-repo`: 指定 Maven 仓库路径,将 `/custom/path/to/maven/repository` 内容替换为本地 Maven 仓库路径即可,不配置时依次读取 `MAVEN_REPO`、用户 settings、Maven 全局 settings,最后使用 `~/.m2/repository`
  75. ```json
  76. {
  77. "mcpServers": {
  78. "easy-code-reader": {
  79. "command": "uvx",
  80. "args": [
  81. "easy-code-reader",
  82. "--maven-repo",
  83. "/custom/path/to/maven/repository"
  84. ],
  85. "env": {}
  86. }
  87. }
  88. }
  89. ```
  90. 将以上内容配置好后,AI 助手即可通过 MCP 协议调用 Easy Code Reader 提供的工具,完成 Maven 依赖的 Java 源代码读取工作。
  91. <a id="quick-start-uv"></a>
  92. ## 快速接入(方法二):使用 uv 安装到本地
  93. 如果使用 **快速接入(方法一)** 安装运行失败,那么可以采用直接安装到本地的方法,运行如下命令:
  94. ```bash
  95. uv tool install easy-code-reader
  96. ```
  97. 安装成功后,执行以下命令获取安装目录:
  98. ```bash
  99. which easy-code-reader
  100. ```
  101. 比如,输出结果是:/Users/fangyuan/.local/bin/easy-code-reader,则将它填入 MCP 客户端的 `command`,启动参数填入 `args`:
  102. ```json
  103. {
  104. "mcpServers": {
  105. "easy-code-reader": {
  106. "command": "/Users/fangyuan/.local/bin/easy-code-reader",
  107. "args": [
  108. "--maven-repo",
  109. "/custom/path/to/maven/repository"
  110. ],
  111. "env": {}
  112. }
  113. }
  114. }
  115. ```
  116. 一般这样操作都能完成安装,后续如果有版本更新,可以通过以下命令进行升级:
  117. ```bash
  118. uv tool install --upgrade easy-code-reader
  119. ```
  120. ## 常见问题
  121. ### Q1: 启动时提示 spawn uvx ENOENT
  122. uv 命令未找到,确保已正确安装 uv 并将其路径添加到系统 PATH 中,参考 [环境要求](#quick-start-env),并尝试重启 IDE 后再启动 MCP Server。
  123. ### Q2: 首次下载 Python 或依赖时超时
  124. 可先在终端按[快速接入(方法二)](#quick-start-uv)完成安装,再配置 MCP 客户端;调试本地源码时,也可按[本地开发与验证](#local-development)使用已安装的 Python 创建环境。
  125. ---
  126. ## 工具说明
  127. Easy Code Reader 提供两个工具,用于查找 Maven 坐标和读取 JAR 包源码。
  128. ### search_group_id
  129. 根据 artifactId 和可选的 groupId 前缀,在本地 Maven 仓库中查找 groupId 及可用版本,辅助调用 `read_jar_source`。
  130. **参数:**
  131. - `artifact_id`(必需):不含版本号的 Maven artifact ID,例如 `spring-core`。
  132. - `group_prefix`(可选):完整 groupId 前缀(按点号分段匹配,不区分大小写),例如 `org.springframework`,用于缩小搜索范围。
  133. - `version_hint`(可选):版本子串,例如 `5.3.21` 或 `SNAPSHOT`;不确定版本时可不传。
  134. 每次调用都直接搜索当前 Maven 仓库,不缓存搜索结果。新依赖安装或删除后,下次搜索即可反映变化。
  135. **示例:**
  136. ```json
  137. {
  138. "artifact_id": "spring-core",
  139. "group_prefix": "org.springframework",
  140. "version_hint": "5.3.21"
  141. }
  142. ```
  143. **返回内容:**
  144. - `matches`:按 groupId 排序的候选列表,每项包含 `group_id`、`matched_versions`(按 Maven 版本顺序降序排列,最多 10 个)和 `total_versions`。
  145. - `total_matches`:匹配的 groupId 数量。
  146. - `search_stats`:实际扫描目录数和耗时;`scanned_groups` 保留为扫描目录数的兼容字段。
  147. - `hint`:后续操作建议。
  148. **典型工作流:**
  149. 1. 使用 `search_group_id` 查找 groupId 和可用版本。
  150. 2. 从结果中选择正确的 Maven 坐标。
  151. 3. 使用 `read_jar_source` 读取指定类的源码。
  152. 没有匹配结果时,检查 artifact ID 拼写,放宽 `group_prefix` 或移除 `version_hint` 后重试。
  153. ### read_jar_source
  154. 从本地 Maven 依赖读取 Java 类源码,依次尝试 sources JAR、反编译缓存和原始 JAR 反编译。
  155. **参数:**
  156. - `group_id` (必需): Maven group ID,例如 `org.springframework`
  157. - `artifact_id` (必需): Maven artifact ID,例如 `spring-core`
  158. - `version` (必需): Maven version,例如 `5.3.21`
  159. - `class_name` (必需): 完全限定的类名,例如 `org.springframework.core.SpringVersion`
  160. - `prefer_sources`(可选,默认 `true`):优先读取 sources JAR;设为 `false` 时跳过源码包,但仍会复用有效的反编译缓存。
  161. - `start_line` / `end_line`(可选):从 1 开始,包含首尾;不传时保持全文返回。只传一端时读取到对应文件边界。起始行越界或范围倒置返回错误,结束行超过文件长度时取文件末尾。
  162. **读取流程:**
  163. 1. 校验参数,定位 Maven 依赖;二进制主包存在时,先确认目标 `.class` 条目及基本文件头有效。
  164. 2. `prefer_sources=true` 时,尝试从 sources JAR 读取目标源码;支持只有源码包的依赖版本。
  165. 3. 源码不可用时,检查 `easy-code-reader/` 下的正式缓存。缓存有效则直接返回。
  166. 4. 缓存未命中时,反编译器直接读取原始 JAR,反编译整个包,再从结果中读取请求类的源码。
  167. 5. 结果校验并写入正式缓存后,执行缓存容量清理和本次临时目录清理,然后返回源码。
  168. **SNAPSHOT 选择规则:**
  169. | 仓库中的主包 | 实际反编译输入 | 缓存文件名 |
  170. |---|---|---|
  171. | 普通 SNAPSHOT 和时间戳包都存在 | 普通 SNAPSHOT 主包 | 最新时间戳主包名 |
  172. | 只有普通 SNAPSHOT 主包 | 普通 SNAPSHOT 主包 | 与主包同名 |
  173. | 只有时间戳主包 | 最新时间戳主包 | 与该时间戳包同名 |
  174. 时间戳按日期时间和数字构建号排序。普通 SNAPSHOT 主包优先使用普通 sources,缺失时尝试该时间戳构建的 sources;直接读取时间戳主包时匹配其 sources。普通发布版本精确匹配主包及对应 sources。
  175. 内部类名使用 `Outer$Inner`,必要时返回包含它的外部类源码并附带提示。仅有 sources JAR 时也可以读取;`tests`、`all` 等 classifier 包不会被当作主包。
  176. **错误处理:**
  177. 失败时 MCP 响应设置 `isError=true`,文本内容中的 JSON 包含 `error.code`、`error.message` 和 `error.hint`。例如:
  178. ```json
  179. {
  180. "error": {
  181. "code": "ARTIFACT_NOT_FOUND",
  182. "message": "未找到 JAR 文件: org.example:demo:1.0",
  183. "hint": "使用 search_group_id 核对 Maven 坐标。"
  184. }
  185. }
  186. ```
  187. 常见错误码包括 `INVALID_ARGUMENT`、`CONFIG_ERROR`、`ARTIFACT_NOT_FOUND`、`CLASS_NOT_FOUND`、`SOURCE_DECODE_ERROR`、`INVALID_JAR`、`DECOMPILER_UNAVAILABLE`、`DECOMPILE_FAILED`、`DECOMPILE_TIMEOUT`、`CACHE_UNAVAILABLE` 和 `INPUT_CHANGED`。
  188. JAR 缺失时可先用 `search_group_id` 核对坐标;依赖需要预先通过 Maven 下载或安装到本地仓库。反编译失败会返回错误说明。
  189. **示例:**
  190. ```json
  191. {
  192. "group_id": "org.springframework",
  193. "artifact_id": "spring-core",
  194. "version": "5.3.21",
  195. "class_name": "org.springframework.core.SpringVersion"
  196. }
  197. ```
  198. **返回结构示例(`code` 已简化):**
  199. ```json
  200. {
  201. "class_name": "org.springframework.core.SpringVersion",
  202. "artifact": "org.springframework:spring-core:5.3.21",
  203. "source_type": "sources.jar",
  204. "code": "package org.springframework.core;\n\npublic class SpringVersion {\n // ...\n}"
  205. }
  206. ```
  207. 全文读取仅返回上面四个字段。显式传入行范围时,另外返回 `total_lines`、`start_line`、`end_line` 和 `is_partial`。内部类映射或源码解码回退等特殊情况可附带简短的 `warnings`。实际 JAR 路径和解析版本仅用于内部处理及调试日志。
  208. **source_type 字段说明:**
  209. `source_type` 字段标识源码的来源,帮助 AI 助手了解代码的可靠性和新鲜度:
  210. - `"sources.jar"`:从本地 sources JAR 提取的源文件
  211. - `"decompiled"`: 通过反编译器新反编译生成(可能存在反编译不完整的情况)
  212. - `"decompiled_cache"`: 从之前反编译的缓存中读取(避免重复反编译,提升性能)
  213. 💡 **使用建议**:
  214. - 有 sources JAR 时优先阅读其中的原始源码
  215. - `decompiled` 来源的代码可能会有语法糖恢复、泛型擦除等反编译特征
  216. - `decompiled_cache` 与 `decompiled` 质量相同,只是从缓存读取以提升效率
  217. ---
  218. ## 技术细节
  219. ### 项目结构
  220. ```
  221. easy-code-reader/
  222. ├── src/easy_code_reader/
  223. │ ├── __init__.py # Python 包入口
  224. │ ├── __main__.py # 程序入口点
  225. │ ├── server.py # 两个 MCP Tool 与使用指南
  226. │ ├── service.py # 源码读取流程
  227. │ ├── repository.py # Maven 文件解析与实时搜索
  228. │ ├── versions.py # Maven 版本排序
  229. │ ├── source.py # 内部类、源码提取与行范围
  230. │ ├── cache.py # 按 JAR 名称保存的磁盘缓存
  231. │ ├── errors.py # 统一错误
  232. │ ├── io_utils.py # 可安全取消的文件操作调度
  233. │ ├── config.py # 配置管理
  234. │ ├── decompiler.py # 反编译器集成
  235. │ └── decompilers/ # 反编译器 JAR 文件目录
  236. │ ├── fernflower.jar # Fernflower 反编译器
  237. │ └── cfr.jar # CFR 反编译器
  238. ├── tests/ # 测试文件
  239. ├── scripts/ # MCP 冒烟验证与发布脚本
  240. ├── docs/CHANGELOG.md # 版本变更说明
  241. ├── pyproject.toml # Python 项目配置
  242. ├── requirements.txt # Python 依赖
  243. └── README.md # 本文档
  244. ```
  245. ### 反编译器
  246. 按运行时 Java 版本选择优先使用的反编译器:
  247. | Java 运行时版本 | 优先使用 | 说明 |
  248. |---|---|---|
  249. | 6–20 | CFR | 使用随包提供的 `decompilers/cfr.jar` |
  250. | 21 及以上 | Fernflower | 使用随包提供的 `decompilers/fernflower.jar`,失败时可尝试 CFR |
  251. 只有满足 Java 运行要求且文件可用的反编译器会被执行;尝试备用反编译器也计入同一次请求的超时预算。Fernflower 显式开启泛型签名恢复(`-dgs=1`),以保留字节码中已有的泛型信息。反编译结果仍可能存在语法糖等还原差异。
  252. #### 反编译缓存与执行
  253. 缓存直接保存在实际 JAR 所在版本目录的 `easy-code-reader/` 下,无需单独配置缓存路径。普通版本与原始 JAR 同名;SNAPSHOT 有时间戳包时使用最新时间戳包名,否则使用普通 SNAPSHOT 包名。
  254. ```text
  255. ~/.m2/repository/org/example/demo/1.0-SNAPSHOT/
  256. ├── demo-1.0-SNAPSHOT.jar # 优先作为反编译输入
  257. ├── demo-1.0-20260916.120000-2.jar # 用于确定缓存版本名称
  258. └── easy-code-reader/
  259. └── demo-1.0-20260916.120000-2.jar
  260. ```
  261. 最新时间戳包名变化时使用新的缓存文件。缓存内部记录实际读取的输入包的大小和修改时间;普通 SNAPSHOT 包更新后,即使时间戳文件名不变也会重新生成缓存。若同名文件被覆盖且大小、修改时间均未变化,需要手动删除对应缓存。
  262. 缓存命中时直接读取磁盘文件。缓存缺失时,反编译器直接读取解析出的原始 JAR,并将中间输出写入独立临时目录;反编译结果经过校验、确认原始文件未发生变化后,通过原子替换写入正式缓存。并发请求使用各自的临时输出目录,完成后清理。
  263. 每次新缓存生成后,按该版本目录默认 1 GiB 的预算清理较久未使用的新格式缓存。本次刚生成的缓存不在该次清理中删除,因此预算可能暂时超过。已有同名缓存缺少输入校验信息时,在下一次读取对应 JAR 时重新生成。
  264. 反编译需要对应 Maven 缓存目录可写,权限不足时明确报错;直接读取 sources JAR 不需要写入缓存。Python 安装目录无需写权限。
  265. - `--decompile-timeout`:反编译请求预算,默认 60 秒;超时/取消会终止并回收 Java 进程。
  266. - 日志只输出到 stderr,不在安装目录创建文件。
  267. - 源码使用严格 UTF-8 解码;失败可回退到对应二进制包,并附带 `warnings`。
  268. - MCP 调用等待源码读取或反编译完成后一次性返回结果;异步子进程让服务器在等待 Java 时继续处理其他请求及取消,不返回后台任务 ID,也不需要客户端轮询。
  269. ### 配置与迁移
  270. Maven 路径优先级为 `--maven-repo` → `MAVEN_REPO` → `~/.m2/settings.xml` 的 `localRepository` → Maven 安装目录的 `conf/settings.xml` → `~/.m2/repository`。`MAVEN_HOME` / `M2_HOME` 用于定位 Maven 安装目录,不再拼接 `/repository`。原来依赖此行为的用户应显式配置 `--maven-repo`。
  271. 支持 `~`、相对路径(相对于服务器启动工作目录)、`${user.home}` 和 `${env.NAME}`。未解析的 settings 变量会给出错误,可通过启动参数覆盖。
  272. 本版本要求 `mcp>=1.30,<2`。`read_jar_source` 保持默认全文返回;`group_prefix` 按完整 groupId 前缀分段匹配,例如 `org.springframework`,原先使用中间子串的调用应相应调整。详见 [1.4.0 变更说明](docs/CHANGELOG.md)。
  273. <a id="local-development"></a>
  274. ## 本地开发与验证
  275. 以下命令从仓库根目录执行,适用于 macOS/Linux;已有 `.venv` 时可跳过环境创建:
  276. ```bash
  277. uv venv .venv --python python3
  278. uv pip install --python .venv/bin/python -e ".[dev]"
  279. .venv/bin/python -m easy_code_reader --help
  280. .venv/bin/python -m pytest -q
  281. .venv/bin/python scripts/smoke_test.py
  282. ```
  283. 可编辑安装会加载当前仓库代码。冒烟脚本创建临时 Maven 仓库和真实编译的 JAR,通过 MCP stdio 验证工具发现、搜索、全文/分段读取、反编译、缓存及错误响应;成功时输出 `"smoke": "passed"` 和各步骤耗时。
  284. 使用 `mcpServers` JSON 配置的客户端,可将本地虚拟环境 Python 的绝对路径填入 `command`:
  285. ```json
  286. {
  287. "mcpServers": {
  288. "easy-code-reader-local": {
  289. "command": "/absolute/path/to/easy-code-reader/.venv/bin/python",
  290. "args": [
  291. "-m",
  292. "easy_code_reader",
  293. "--maven-repo",
  294. "/absolute/path/to/maven/repository"
  295. ]
  296. }
  297. }
  298. }
  299. ```
  300. 项目使用 stdio 通信,由 MCP 客户端启动服务进程。手动启动后等待输入是正常行为。修改代码后需要断开并重新连接,让 Python 进程重新加载模块。
  301. 构建并检查分发包:
  302. ```bash
  303. .venv/bin/python -m build
  304. .venv/bin/python -m twine check dist/*
  305. ```
  306. Windows 中将 `.venv/bin/python` 替换为 `.venv/Scripts/python.exe`,并使用对应终端的路径语法。
  307. <a id="inspector-debugging"></a>
  308. ## 使用 MCP Inspector 调试
  309. 完成本地可编辑安装后,可使用以下已验证的 Inspector 2.7.0 命令(macOS/Linux)。仓库路径以 `~/.m2/repository` 为例,可替换为实际路径:
  310. ```bash
  311. npx --registry=https://registry.npmjs.org -y \
  312. @modelcontextprotocol/inspector@2.7.0 \
  313. "$PWD/.venv/bin/python" -- \
  314. -m easy_code_reader \
  315. --maven-repo "$HOME/.m2/repository"
  316. ```
  317. 此命令为本次下载指定 npm 官方源,不修改全局 npm 配置。Inspector 会启动本地 Web 界面;打开终端打印的完整地址,其中包含本次会话的访问令牌。
  318. 1. 在 **Servers** 中选择预填的本地服务,点击 **Connect**。
  319. 2. 进入 **Tools**,确认存在 `search_group_id` 和 `read_jar_source`。
  320. 3. 先用 `search_group_id` 查询 `artifact_id=spring-core`、`group_prefix=org.springframework`,选择本地实际存在的版本。
  321. 4. 调用 `read_jar_source` 读取 `org.springframework.core.SpringVersion`,将 `prefer_sources` 设为 `false`,连续调用两次。无有效缓存时第一次返回 `decompiled`,后续返回 `decompiled_cache`;若已有有效缓存,第一次也可以命中缓存。
  322. 5. 可再设置 `start_line`、`end_line` 验证分段读取;不使用可选参数时,在表单中省略对应字段。
  323. 工具返回在 **Tools** 中查看,进程 stderr 在 **Console** 中查看,协议请求与响应在 **Protocol** 中查看。修改代码后断开再连接即可重新加载。
  324. 参考:[Inspector 官方说明](https://modelcontextprotocol.io/docs/tools/inspector)、[Web 界面说明](https://modelcontextprotocol.io/docs/2026-07-28/tools/inspector/web)。
  325. ## 当前适用范围
  326. 输入为本地 Maven 坐标和完整 Java 类名,依赖需要预先下载或安装到仓库中。读取顶层/基础版本的类路径,暂不处理嵌套 JAR 或 Multi-release 的运行时版本选择。
  327. ## 许可证
  328. Apache License 2.0,详见 [LICENSE](LICENSE) 文件。
  329. ## 巨人的肩膀
  330. - [Github: maven-decoder-mcp](https://github.com/salitaba/maven-decoder-mcp)
  331. - [Github: fernflower](https://github.com/JetBrains/fernflower)
  332. - [Github: Model Context Protocol(MCP) 编程极速入门](https://github.com/liaokongVFX/MCP-Chinese-Getting-Started-Guide)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.