How do I use Java Decompiler MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Java Decompiler MCP Server decompile the jar file at /libs/app.jar and save the source to ./decompiled" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Java Decompiler MCP Server

一个基于 MCP (Model Context Protocol) 的 Java 反编译工具，使用 CFR 反编译器对 .class 和 .jar 文件进行反编译。

功能特性

✅ 单个文件反编译（.class / .jar）
✅ 多个文件批量反编译
✅ 目录递归扫描反编译
✅ 自定义输出目录
✅ 自动下载 CFR 反编译器
✅ 直接保存到文件系统（避免 token 限制）
✅ 实时进度显示
✅ 详细统计信息
✅ 多线程并发处理（大幅提升速度）

改进亮点

🚀 解决大文件/大量文件反编译问题

问题： 当反编译大量文件时，如果将所有结果作为字符串返回，可能超过 MCP 的 token 限制（例如 413,072 字符）。

解决方案：

直接保存到文件系统（推荐）
- 新增 save_to_file 参数（默认 true）
- 反编译结果直接写入指定目录
- 仅返回摘要信息（成功数、失败数、输出路径等）
- 避免通过 MCP 传输大量内容
实时进度显示
- 新增 show_progress 参数（默认 true）
- 显示当前处理进度：[1/46] 处理中: Controller.class
- 实时反馈处理状态
详细统计报告
- 成功/失败/跳过文件数
- 生成的 .java 文件总数
- 输出目录路径
- 清晰的格式化输出

使用示例

场景 1：反编译大量文件（推荐方式）

# 使用 8 个线程并发处理，大幅提升速度 decompile_directory( directory_path="/path/to/classes", output_dir="/path/to/output", save_to_file=True, # 默认值 show_progress=True, # 显示进度 max_workers=8 # 8 线程并发 )

场景 2：反编译少量文件并查看内容

# 返回反编译内容（仅适用于小文件） decompile_file( file_path="/path/to/MyClass.class", save_to_file=False # 返回内容而不是保存 )

场景 3：静默批量处理

# 不显示详细进度，仅返回统计，单线程处理 decompile_files( file_paths=[...], show_progress=False, # 仅显示统计信息 max_workers=1 # 单线程 )

环境要求

Python >= 3.10
Java Runtime Environment (JRE)
uv (Python 包管理器)

安装

方式一：通过 uvx 直接使用（推荐）

无需安装，直接在 MCP 配置中使用(可让ai自动下载cfr-0.152.jar然后你手动配置路径)：

{ "mcpServers": { "java-decompiler": { "type": "stdio", "command": "uvx", "args": ["java-decompile-mcp"], "env": { "CFR_PATH": "/你的路径/cfr-0.152.jar" }, "disabled": false } } }

方式二：本地开发

# 克隆项目 git clone <repository-url> cd java-decompile-mcp # 创建虚拟环境并安装依赖 uv venv source .venv/bin/activate # macOS/Linux # 或 .venv\Scripts\activate # Windows uv pip install "mcp>=1.0.0"

MCP 配置

方式一：使用 uvx（推荐，已发布到 PyPI）

在 .kiro/settings/mcp.json 或 claude_desktop_config.json 中添加：

{ "mcpServers": { "java-decompiler": { "command": "uvx", "args": ["java-decompile-mcp"], "disabled": false } } }

方式二：本地开发模式

在 .kiro/settings/mcp.json 中添加：

{ "mcpServers": { "java-decompiler": { "command": "uv", "args": [ "--directory", "/项目路径", "run", "main.py" ], "disabled": false, "autoApprove": [] } } }

⚠️ 本地开发模式需要将路径替换为实际的项目路径

项目地址

GitHub: https://github.com/RuoJi6/java-decompile-mcp

可用工具

1. decompile_file

反编译单个文件

参数：

file_path (必需): 要反编译的文件路径
output_dir (可选): 输出目录，默认为文件所在目录下的 decompiled 文件夹
save_to_file (可选): 是否直接保存到文件系统，默认 true（推荐）

示例：

反编译 /path/to/MyClass.class 到 /output/dir

返回结果：

✅ 反编译成功源文件: /path/to/MyClass.class 输出目录: /output/dir 生成文件数: 1 提示: 反编译结果已保存到文件系统

2. decompile_files

批量反编译多个文件（支持多线程）

参数：

file_paths (必需): 文件路径列表
output_dir (可选): 输出目录
save_to_file (可选): 是否直接保存到文件系统，默认 true
show_progress (可选): 是否显示详细进度，默认 true
max_workers (可选): 最大并发线程数，默认 4（设为 1 则单线程）

示例：

反编译以下文件： - /path/to/Class1.class - /path/to/Class2.class - /path/to/app.jar 使用 8 个线程并发处理

返回结果：

✅ [1/3] 成功: Class1.class ✅ [2/3] 成功: Class2.class ✅ [3/3] 成功: app.jar ============================================================ 📊 反编译完成统计 ============================================================ ✅ 成功: 3 ❌ 失败: 0 ⏭️ 跳过: 0 📁 总计: 3 个文件 📄 生成: 46 个 .java 文件 📂 输出目录: /output/dir 🔧 并发线程: 4 ============================================================ 💾 反编译结果已保存到文件系统

3. decompile_directory

反编译目录下所有 .class 和 .jar 文件（支持多线程）

参数：

directory_path (必需): 目录路径
output_dir (可选): 输出目录
recursive (可选): 是否递归子目录，默认 true
save_to_file (可选): 是否直接保存到文件系统，默认 true
show_progress (可选): 是否显示详细进度，默认 true
max_workers (可选): 最大并发线程数，默认 4

示例：

反编译 /path/to/classes 目录下的所有 class 文件，使用 8 个线程

返回结果：

📂 扫描目录: /path/to/classes 🔍 找到 46 个文件待反编译 📤 输出目录: /path/to/classes/decompiled 🔧 并发线程: 4 ✅ [1/46] 成功: Controller1.class ✅ [2/46] 成功: Controller2.class ... ✅ [46/46] 成功: Utils.class ============================================================ 📊 反编译完成统计 ============================================================ ✅ 成功: 46 ❌ 失败: 0 ⏭️ 跳过: 0 📁 总计: 46 个文件 📄 生成: 46 个 .java 文件 📂 输出目录: /path/to/classes/decompiled 🔧 并发线程: 4 ============================================================ 💾 反编译结果已保存到文件系统

4. download_cfr_tool

下载 CFR 反编译器

参数：

target_dir (可选): 下载目标目录，默认当前工作目录

5. check_cfr_status

检查 CFR 反编译器状态

6. get_java_version

获取 Java 版本信息

CFR 配置

CFR 反编译器查找顺序：

环境变量 CFR_PATH
项目目录下的 cfr-*.jar
自动下载（首次调用反编译工具时）

方式一：MCP 配置中指定（推荐）

在 mcp.json 的 env 中设置：

{ "mcpServers": { "java-decompiler": { "command": "uv", "args": ["--directory", "/项目路径", "run", "main.py"], "env": { "CFR_PATH": "/你的路径/cfr-0.152.jar" } } } }

方式二：放到项目目录

将 cfr-*.jar 文件放到项目根目录，会自动识别。

方式三：自动下载

调用 download_cfr_tool 工具，会自动从镜像下载到项目目录。

手动运行测试

# 激活虚拟环境 source .venv/bin/activate # 运行 MCP 服务器 uv run main.py

许可证

MIT License

Java Decompiler MCP Server

Java Decompiler MCP Server

功能特性

改进亮点

🚀 解决大文件/大量文件反编译问题

使用示例

环境要求

安装

方式一：通过 uvx 直接使用（推荐）

方式二：本地开发

MCP 配置

方式一：使用 uvx（推荐，已发布到 PyPI）

方式二：本地开发模式

项目地址

可用工具

1. decompile_file

2. decompile_files

3. decompile_directory

4. download_cfr_tool

5. check_cfr_status

6. get_java_version

CFR 配置

方式一：MCP 配置中指定（推荐）

方式二：放到项目目录

方式三：自动下载

手动运行测试

许可证

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API