ilspymcp 1.4.0

ilspymcp

内置 ICSharpCode.Decompiler 的 .NET 反编译 MCP 服务器。在 opencode 等 MCP 客户端中直接对 .NET 程序集（dll / exe）做反编译、类型探测与源码写盘。反编译引擎随包内置，开箱即用。

目录

• 环境要求
• 安装
• 接入 opencode
• 核心约定
• 工具一览
• 命令行调试
• 工具参数
• 使用示例
• License

环境要求

• .NET 10 SDK

安装

dotnet tool install --global ilspymcp   # 安装
dotnet tool update --global ilspymcp    # 升级
dotnet tool uninstall --global ilspymcp # 卸载

查看版本 / 帮助：ilspymcp -v / ilspymcp -h

接入 opencode

opencode.json 中注册本地 MCP：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ilspy": {
      "type": "local",
      "command": ["ilspymcp"]
    }
  }
}

重启 opencode 后工具以 ilspy_* 前缀暴露。握手时 server 会注入当前工作目录，assembly / outputDir 的相对路径以此解析。

核心约定

• 输出带头部信息块：程序集 / 目标 / 总行数 / 当前输出 / 剩余 + --- 分隔线，命中缓存时追加 缓存: 命中。
• 行号与分页：结果按 行号<TAB>内容 输出，默认返回前约 8 KB，可用 lines="start-end"（如 200-400）按行号分页，单次最多约 32 KB。
• 缓存：除写盘工具外全部结果按 程序集 + 参数 共享缓存（64 MB LRU，固定 30 分钟滑动过期 + 5 分钟定时清理，程序集更新自动失效），超时/失败不入缓存。
• 类型名格式：与 ilspy_list_types 输出一致（命名空间.类型，嵌套用 +，泛型带 arity 如 GenericBox`1），行首类别前缀（如 class Foo.Bar）可直接复用。
• Token 闭环：ilspy_signature 每行行尾附成员 token（0x06…），#MEMBER 分隔行含 token，均可直接用于 ilspy_decompile_member / ilspy_call_graph / ilspy_call_chain / ilspy_field_access 精确定位。

工具一览

反编译

结构探测（纯元数据，秒回）

辅助

全部工具内置引擎，无需额外安装。除写盘外均支持 lines 分页；反编译类额外支持 timeoutSeconds（默认 30s）。

命令行调试

MCP 模式外，ilspymcp 可直接以命令行执行同等功能，便于本地调试。参数与 MCP 工具一一对应。

反编译

ilspymcp -a bin/Debug/MyApp.dll -t MyApp.Program                          # ilspy_decompile
ilspymcp -a bin/Debug/MyApp.dll -t MyApp.Program -mn Main                  # ilspy_decompile_member 按名
ilspymcp -a bin/Debug/MyApp.dll -mn Main                                   # 跨程序集按名（省略 -t）
ilspymcp -a bin/Debug/MyApp.dll -tt 0x02000004 -mn Main                    # 按类型 token 消歧后搜成员
ilspymcp -a bin/Debug/MyApp.dll -o src                                     # ilspy_decompile_to_dir 全量
ilspymcp -a bin/Debug/MyApp.dll -o src -t "MyApp.IWorker,MyApp.Worker"     # 批量写盘多类型
ilspymcp -a bin/Debug/MyApp.dll -o src -p --nested-directories             # ilspy_decompile_to_project

结构探测

ilspymcp -a bin/Debug/MyApp.dll -ai                                        # ilspy_assembly_info
ilspymcp -a bin/Debug/MyApp.dll -l csi                                     # ilspy_list_types
ilspymcp -a bin/Debug/MyApp.dll -l c -nc Box -ns ILSpyMcp                 # 名称/命名空间过滤
ilspymcp -a bin/Debug/MyApp.dll -t MyApp.Program -s                        # ilspy_signature
ilspymcp -a bin/Debug/MyApp.dll -t MyApp.Program -hc [-i]                  # ilspy_hierarchy (-i 含间接后代)
ilspymcp -a bin/Debug/MyApp.dll -t MyApp.Program -d [-x]                   # ilspy_dependencies (-x 含外部)
ilspymcp -a bin/Debug/MyApp.dll -t MyApp.Program -cg [-x]                  # ilspy_call_graph
ilspymcp -a bin/Debug/MyApp.dll -cg -tk 0x06000005                         # 按方法 token 反向定位调用者
ilspymcp -a bin/Debug/MyApp.dll -t MyApp.IWorker -iu [-i]                  # ilspy_interface_usage
ilspymcp -a bin/Debug/MyApp.dll -t MyApp.GenericBox -gi                    # ilspy_generic_instantiations
ilspymcp -a bin/Debug/MyApp.dll -ss "配置Key" [-t MyApp.Program]           # ilspy_search_string
ilspymcp -a bin/Debug/MyApp.dll -fa -t MyApp.Program -fn _count            # ilspy_field_access 按名
ilspymcp -a bin/Debug/MyApp.dll -fa -tk 0x04000005                         # 按字段 token
ilspymcp -a bin/Debug/MyApp.dll -t MyApp.Program -mn Parse -cc [-x]        # ilspy_call_chain
ilspymcp -a bin/Debug/MyApp.dll -cc -tk 0x06000010                         # 按方法 token 定位起始方法

通用参数

工具参数

ilspy_decompile

ilspy_decompile_member

多匹配合并输出、各成员前 #MEMBER {"name","token","type"} 分隔行；超过 20 个仅返回签名清单；无匹配时附相近成员名。

ilspy_decompile_to_dir / ilspy_decompile_to_project

ilspy_list_types

ilspy_signature

每行一成员签名，行尾附 token（0x06/0x04/0x17/0x14），可直接用于 decompile_member；未找到时附相近类型名。

ilspy_hierarchy / ilspy_interface_usage / ilspy_generic_instantiations

ilspy_dependencies / ilspy_call_graph

ilspy_search_string / ilspy_field_access / ilspy_assembly_info / ilspy_cache_stats

以上未找到类型时均附相近类型名提示；除 cache_stats 外结果均可缓存，命中时头部标注。

ilspy_call_chain

序列行带内部成员 token；被调内部成员超 20 个仅返签名清单。

使用示例

在 opencode 对话中直接提出：

初探程序集

• 查看 bin/Debug/MyApp.dll 的程序集概览，先摸清引用与类型构成

• 列出 bin/Debug/MyApp.dll 中的所有 class / csi 三类

定位类型与成员

• 反编译 MyApp.Program / 搜索 Main 成员并反编译 / 跨程序集搜索 Parse

• 列出 MyApp.Program 的成员签名（API 地图），取行尾 token 反编译单个成员

• 按行拉取 MyApp.Program 第 200-400 行

继承与引用

• 查看 MyApp.Program 的基类链、接口与继承者（含间接后代 includeIndirect=true）

• 查询 MyApp.Program 的签名引用与反向引用（含外部 includeExternal=true）

• 查询 MyApp.IWorker 的实现者与调用点（含间接实现者）

调用关系

• 查询 MyApp.Program 的方法体调用了哪些类型 / 哪些类型调用了它（含外部）

• 查询哪些方法调用了 MyApp.Program.Parse（先 signature 取 token，再 ilspy_call_graph token=...）

• 追踪 MyApp.Program.Parse 的正向调用序列并反编译被调成员（ilspy_call_chain，includeExternal=true 展开同目录/NuGet 可解析的外部调用）

搜索与字段

• 按字符串 配置Key / order by 反查成员（可限 typeName）

• 追踪字段 _count 的读写点（fieldName 或先 signature 取 0x04… 用 fieldToken）

• 查询泛型 GenericBox 的具体实例化使用点（GenericBox 或 GenericBox`1 均可）

写盘与缓存

• 反编译 bin/Debug/MyApp.dll 到 src（全量 / 指定多类型 / 项目形式嵌套目录）

• 查看缓存占用与命中率（ilspy_cache_stats）

License

MIT