AI导哈

ILSpy MCP 服务器

一个生产级的MCP服务器，提供所有主要的ILSpy CLI功能作为单独的工具，用于反编译.NET程序集。

  • by BROKENISTXD
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 BROKENISTXD/ilspy-mcp-server

使用说明

ILSpy MCP服务器

一个生产级MCP服务器，将所有主要的ILSpy CLI功能作为单独的反编译工具公开。NET程序集。

特性

  • 10个MCP工具：分解、导出项目、提取IL、列出类型/方法、解析引用等
  • 工作流程编排：自动化端到端处理。NET程序集
  • 结构化输出：包含元数据、类型、方法和日志的JSON报告
  • 向前兼容：原始ilspycmd工具不支持的功能
  • 交叉平台的：适用于Windows、Linux和macOS

先决条件

  • Python 3.10+
  • ILSpy CLI（ilspycmd）已安装并在PATH中可用
    • 下载地址：https://github.com/icsharpcode/ILSpy/releases
    • 或通过以下方式安装： dotnet tool install -g ilspycmd

安装

pip install -r requirements.txt

用法

选项1:MCP服务器模式

启动MCP服务器，并将其与任何兼容MCP的客户端一起使用：

python server.py

服务器使用JSON-RPC通过stdio进行通信。使用以下命令在MCP客户端中配置它 config.json.

选项2：直接使用编排器

直接使用编排器处理程序集：

# Single assembly
python orchestrator.py assembly.dll

# Multiple assemblies
python orchestrator.py assembly1.dll assembly2.dll assembly3.exe

# With options
python orchestrator.py assembly.dll --langver:11 --nullable --no-records

选项3：Python API

以编程方式使用编排器：

from orchestrator import process_assemblies, save_report
from pathlib import Path

report = process_assemblies(
    ["assembly.dll"],
    language_version="11",
    nullable_enabled=True,
    handle_records=True,
)

save_report(report, Path("work/report.json"))

工具

  1. 反编译文件 -将程序集解压缩为C#文件

    • 支持： --langver, --nullable, --with-records等等。

  2. 出口工程 -导出可编译的C#项目

    • 包括：引用、元数据、项目文件

  3. get_il -提取IL代码

    • 查看中间语言而不是反编译的C#

  4. list_types -列出装配中的所有类型

    • 返回：命名空间限定类型名称

  5. list_方法 -列出类型的方法

    • 输入：完整类型名称（例如。， Namespace.ClassName)

  6. resolve_references -分析外部参考

    • 摘录：包引用、程序集引用

  7. set_language_version -控制C#语言版本

    • 版本：9、10、11、12等。

  8. enable_nullable_context -启用/禁用可为null的引用类型

    • 选项： true 或 false

  9. handle_records_init_only -正确处理记录类型

    • 确保：记录和仅初始化设置程序正确反编译

  10. raw_ilspycmd -运行任意ilspycmd命令

    • 向前兼容所有未来的ILSpy功能

输出结构

work/
  input/              # Input assemblies (optional)
  output/
    decompile/        # Decompiled C# files
      <assembly>/
        *.cs files
    project/          # Exported projects
      <assembly>/
        *.csproj
        *.cs files
    il/               # IL code output
      <assembly>/
        *.il files
  report.json         # Final structured JSON report

JSON报告格式

编排器生成结构化的JSON报告：

{
  "assemblies": [
    {
      "assembly": "example.dll",
      "status": "success",
      "paths": {
        "decompiled": "work/output/decompile/example/",
        "project": "work/output/project/example/",
        "il": "work/output/il/example/"
      },
      "types": [
        {
          "name": "Namespace.MyClass",
          "methods": ["Main", "DoSomething"],
          "il_size": {"Main": 123, "DoSomething": 42}
        }
      ],
      "references": ["System", "System.Linq"],
      "flags_used": ["--langver:11", "--nullable"],
      "logs": {
        "stdout": "...",
        "stderr": "..."
      }
    }
  ]
}

工作流程

编排器对每个程序集都遵循以下工作流程：

  1. 反编译 → 生成C#源文件
  2. 导出项目 → 创建带有引用的可编译项目
  3. 提取IL → 获取中间语言代码
  4. 列表类型 → 发现装配中的所有类型
  5. 列出方法 → 对于每种类型，提取方法
  6. 解析引用 → 分析依赖关系
  7. 应用设置 → 语言版本、可空上下文、记录
  8. 生成报告 → 将所有元数据收集到JSON中

错误处理

  • 所有工具返回结构化JSON returncode, stdout，以及 stderr
  • 失败的操作标记为 status: "error" 在报告中
  • 调试报告中包含完整的错误日志
  • 工具是幂等的，可以多次安全运行

例子

看 example_usage.py 查看以下完整示例：

  • 处理单个组件
  • 处理多个组件
  • 使用不同的语言版本
  • 启用/禁用可为null的上下文
  • 自定义标志和选项

许可证

此项目封装了ILSpy CLI。有关使用条款，请参阅ILSpy的许可证。

相关 MCP