Dn Spy MCP Server

dnSpy MCP服务器

A. 模型上下文协议（MCP） 嵌入在dnSpy中的服务器，暴露完整。NET程序集分析、编辑、调试、内存转储和去模糊功能，可用于任何兼容MCP的AI助手。

版本: 1.8.0 | 工具: 100+ | 状态：beta| 目标: .净值4.8+。NET 10.0操作系统

______________________________________________________________________

目录

1. 特性
2. 构建和安装
3. 客户端配置
4. 工具参考

- 装配工具 - 类型和成员工具 - 方法和反编译工具 - IL工具 - 控制流工具 - 分析和交叉参考工具 - 编辑工具 - 嵌入式资源工具 - 调试工具 - 源代码映射工具 - 运行时反转工具 - 内存转储和PE工具 - 静态PE分析 - 消毒工具 - 窗口/对话框工具 - 效用

1. 模式语法
2. 分页
3. 使用示例
4. 建筑
5. 项目结构
6. 配置
7. 故障排除

______________________________________________________________________

特性

1.8.0版本发生了什么变化

• 可流式HTTP传输 POST /mcp 现在是主MCP表面
• 使用Echo添加了受控CIL控制流分析
• 添加了受HoLLy启发的非UI SourceMap支持
• 运行时反向支持通过本机导出解析、Iced反汇编、补丁跟踪、PEB检查、线程挂起和DLL注入进行了扩展
• 通过以下方式添加了持久管理拦截 trace_method 和 hook_function
• 工具可发现性现在包括目录元数据，例如 category, hidden_by_default, is_legacy，以及 preferred_replacement

Echo集成

dnSpy.MCP.Server 仅集成Echo的稳定管理子集：

• Echo.Core
• Echo.ControlFlow
• Echo.Platforms.Dnlib

MCP服务器会 不 端口HoLLy UI、MSAGL、AsmResolver后端或符号执行。Echo集成仅限于可序列化的CIL控制流分析，MCP客户端和LLM可以可靠地使用该分析。

______________________________________________________________________

构建和安装

先决条件

de4dot集成 --de4dot库捆绑在 libs/de4dot/ （net48）和 libs/de4dot-net8/ （网络8/网络10）。不需要外部依赖；这两个构建目标中都提供了所有的debuscation工具。

克隆和还原

git clone https://github.com/dnSpyEx/dnSpy --recursive
cd dnSpy

构建命令

# Build only the MCP Server extension (Debug)
dotnet build Extensions/dnSpy.MCP.Server/dnSpy.MCP.Server.csproj -c Debug

# Build only the MCP Server extension (Release)
dotnet build Extensions/dnSpy.MCP.Server/dnSpy.MCP.Server.csproj -c Release

# Build the full dnSpy solution (both targets)
dotnet build dnSpy.sln -c Debug

# Build for a specific target framework only
dotnet build Extensions/dnSpy.MCP.Server/dnSpy.MCP.Server.csproj -c Release -f net10.0-windows
dotnet build Extensions/dnSpy.MCP.Server/dnSpy.MCP.Server.csproj -c Release -f net48

# Restore NuGet packages without building
dotnet restore Extensions/dnSpy.MCP.Server/dnSpy.MCP.Server.csproj

# Clean build artifacts
dotnet clean Extensions/dnSpy.MCP.Server/dnSpy.MCP.Server.csproj

输出位置

MCP服务器DLL直接输出到dnSpy的bin目录中，因此当您启动dnSpy时，它会自动加载。

验证构建

# Check for errors (expects "Compilación correcta" or "Build succeeded")
dotnet build Extensions/dnSpy.MCP.Server/dnSpy.MCP.Server.csproj -c Release --nologo 2>&1 | tail -5

运行时

1. 启动dnSpy——MCP服务器自动启动 http://localhost:3100
2. 验证它是否正在运行：

   curl http://localhost:3100/health
   curl -i -X POST http://localhost:3100/mcp -H "Content-Type: application/json" -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\",\"params\":{\"protocolVersion\":\"2025-03-26\",\"capabilities\":{},\"clientInfo\":{\"name\":\"probe\",\"version\":\"1.0\"}}}"

1. 配置您的MCP客户端（见下一节）

______________________________________________________________________

客户端配置

服务器现在使用 MCP流式HTTP 作为主要交通工具 http://localhost:3100/mcp.

运输摘要

• GET /health 返回一个简单的健康有效负载
• POST /mcp 接受JSON-RPC MCP请求
• initialize 返回协商的协议版本和 Mcp-Session-Id 响应头
• 随后的 tools/list 和 tools/call 请求必须包括 Mcp-Session-Id

通用MCP客户端配置

{
  "mcpServers": {
    "dnspy": {
      "type": "http",
      "url": "http://localhost:3100/mcp"
    }
  }
}

最小HTTP示例

curl -X POST http://localhost:3100/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": { "name": "example-client", "version": "1.0" }
    }
  }'

一些MCP客户端仍然将流式HTTP标记为 http, streamable-http，或 remote 这取决于它们的配置格式。端点是相同的： http://localhost:3100/mcp.

______________________________________________________________________

工具参考

所有工具在MCP上称为 tools/call 使用JSON参数对象。 标记的参数 必需的 必须始终提供；所有其他选项都是可选的。

______________________________________________________________________

装配工具

用于列出和检查的工具。NET程序集已加载到dnSpy中。

参数详细信息

______________________________________________________________________

类型和成员工具

用于检查特定类型内部构件的工具。

参数详细信息

______________________________________________________________________

方法和反编译工具

用于反编译代码和探索方法元数据的工具。

参数详细信息

______________________________________________________________________

IL工具

方法体的低水平IL检查。

参数详细信息(dump_cordbg_il)

______________________________________________________________________

控制流工具

在dnlib支持的方法体上使用Echo对CIL方法进行可序列化的托管控制流分析。

get_basic_blocks 有意采用紧凑的摘要形式 get_control_flow_graph.

______________________________________________________________________

分析和交叉参考工具

所有加载程序集的调用图、使用情况和依赖关系分析。

参数详细信息

______________________________________________________________________

编辑工具

内存元数据编辑。更改会立即应用于dnlib的内存模型，并持续到 save_assembly 被调用或dnSpy关闭而不保存。

参数详细信息

备注: rename_member 仅更改元数据名称。确实如此 不 更新调用站点、字符串文字或XML文档。

备注: patch_method_to_ret 非常适合在保存和重新分析之前禁用防调试、防篡改或许可证检查例程。

______________________________________________________________________

嵌入式资源工具

从ManifestResource表中读取、写入和提取条目。所有写入操作都在内存中，直到 save_assembly 被称为。

参数详细信息

科斯图拉。Fody工作流程: list_resources （确认 costura.* 条目存在）→ extract_costura output_directory=C:\extracted → load_assembly 每个提取的DLL→ 使用MCP工具正常分析。

______________________________________________________________________

技能知识库

存储在中的持久逆向工程知识库 %APPDATA%\dnSpy\dnSpy.MCPServer\skills\每个技能都是一对文件：一个Markdown叙述({id}.md)JSON技术记录({id}.json).技能捕捉了分步过程、魔术值、加密密钥、算法、偏移量和通用提示——因此，一旦你反转了打包器或混淆器，这些知识就可以重复使用。

工作流程：在分析新二进制文件之前，调用 search_skills 检查现有知识。完成分析后，致电 save_skill 记录调查结果。

参数详细信息

JSON技能记录结构示例

{
  "id": "confuserex-unpacking",
  "name": "ConfuserEx Unpacking",
  "version": "1",
  "tags": ["packer", "confuserex", "unpacking"],
  "targets": ["MyProtectedApp.exe"],
  "description": "Step-by-step procedure to unpack ConfuserEx 1.x protected assemblies",
  "procedure": [
    { "step": 1, "tool": "detect_obfuscator", "prompt": "Detect which obfuscator was applied", "expected": "ConfuserEx v1.x" },
    { "step": 2, "tool": "start_debugging",   "prompt": "Launch under dnSpy with break_kind=EntryPoint", "expected": "Paused at entry point after .cctor" },
    { "step": 3, "tool": "dump_module_from_memory", "prompt": "Dump decrypted module from RAM", "expected": "Raw PE bytes" }
  ],
  "magic_values": { "key_offset": "0x1234", "xor_key": "0xDEADBEEF" },
  "crypto_keys": [],
  "algorithms": ["XOR", "AES-128-ECB"],
  "prompts": {
    "identify": "Use detect_obfuscator on the assembly. If ConfuserEx, proceed with this skill.",
    "apply": "Follow procedure steps 1-3. After dump, reload and deobfuscate.",
    "verify": "Decompile Main() — if readable C# appears, unpacking succeeded.",
    "troubleshoot": "If dump_module_from_memory fails, try dump_module_unpacked with fix_pe_header=true."
  }
}

______________________________________________________________________

调试工具

与dnSpy的集成调试器交互。大多数工具都需要一个活动的调试会话。

参数详细信息

小贴士：使用 start_debugging + break_kind: EntryPoint 对于ConfusedEx打包的程序集，方法体在断点命中时被解密。然后使用 dump_module_from_memory 或 unpack_from_memory.

步骤工作流程: break_debugger （或等待BP）→ get_current_location → step_over / step_into → 检查 get_local_variables 或 eval_expression → 重复。

______________________________________________________________________

源代码映射工具

SourceMap支持从HoLLy有用的非UI部分移植而来。这些工具将命名数据保存在MCP缓存中，而不依赖于HoLLy选项卡或菜单。

______________________________________________________________________

运行时反转工具

流程级反向和持久拦截工具。

hook_function 故意拒绝 modify_return 而不是暴露一个不稳定的实现。

______________________________________________________________________

内存转储和PE工具

从已调试的进程中提取原始字节。除非另有说明，否则需要活动调试会话。

参数详细信息

布局说明: dump_module_from_memory 报告 IsFileLayout 在其回应中。如果 false，使用 dump_module_unpacked 而是用于校正PE布局。

______________________________________________________________________

静态PE分析

对原始PE文件字节进行操作的工具——不需要调试会话。

参数详细信息

工作流程: scan_pe_strings → 了解打包的二进制文件包含什么→ unpack_from_memory → deobfuscate_assembly → 在dnSpy中加载干净的文件。

______________________________________________________________________

消毒工具

两种de4dot集成模式： 过程中的 (deobfuscate_assembly --使用捆绑的de4dot库，在所有版本中都可用）以及 外部进程 (run_de4dot --产卵 de4dot.exe，支持动态字符串解密，在所有版本中都可用）。

参数详细信息

______________________________________________________________________

窗口/对话框工具

枚举和关闭对话框（Win32 MessageBox, #32770 对话框和WPF窗口），例如阻止调试会话的错误弹出窗口。不需要调试会话。

参数详细信息

按钮匹配 --该工具首先检查常见的精确标记（EN+ES），然后回退到子字符串匹配。如果没有匹配的按钮， WM_CLOSE 发送到对话框。

示例

// List all open dialogs
{ "tool": "list_dialogs" }

// Dismiss the first dialog by clicking OK
{ "tool": "close_dialog" }

// Dismiss a specific dialog by HWND, clicking Cancel
{ "tool": "close_dialog", "arguments": { "hwnd": "1A2B3C", "button": "cancel" } }

______________________________________________________________________

效用

______________________________________________________________________

模式语法

一些工具接受 name_pattern 或 query 同时支持两者的参数 通配符 和 正则表达式 语法。发动机自动检测模式。

所有模式匹配都是 不区分大小写.

# Find all types whose name starts with "Player"
name_pattern: "Player*"

# Find all interfaces (start with I, followed by uppercase)
name_pattern: "^I[A-Z]"

# Find methods ending in "Async"
name_pattern: "Async$"

# Find all Get* or Set* methods
name_pattern: "^(Get|Set)[A-Z]"

______________________________________________________________________

分页

列表操作返回分页结果。默认页面大小为 50个项目.

{
  "items": [ ... ],
  "total_count": 312,
  "returned_count": 50,
  "nextCursor": "eyJvZmZzZXQiOjUwLCJwYWdlU2l6ZSI6NTB9"
}

要获取下一页，请传递 nextCursor 值为 cursor 下次通话中的争论。当 nextCursor 如果不存在，您已到达最后一页。

______________________________________________________________________

使用示例

工作流程：探索未知程序集

1. list_assemblies                           → find "UnityEngine.CoreModule"
2. get_assembly_info  assembly=UnityEngine…  → see namespaces
3. list_types  assembly=…  namespace=UnityEngine  name_pattern="*Manager"
4. get_type_info  assembly=…  type=UnityEngine.NetworkManager
5. decompile_method  …  method=Awake

使用正则表达式在所有程序集中搜索

{ "tool": "search_types", "arguments": { "query": "^I[A-Z].*Repository$" } }

从内存中转储Unity游戏模块

{ "tool": "list_runtime_modules", "arguments": { "name_filter": "Assembly-CSharp*" } }

{ "tool": "dump_module_from_memory", "arguments": {
    "module_name": "Assembly-CSharp.dll",
    "output_path": "C:\\dump\\Assembly-CSharp_dump.dll"
}}

设置断点并检查调用堆栈

{ "tool": "set_breakpoint", "arguments": {
    "assembly_name": "Assembly-CSharp",
    "type_full_name": "PlayerController",
    "method_name": "TakeDamage"
}}

{ "tool": "get_call_stack" }

将私有方法更改为公共方法并保存

{ "tool": "change_member_visibility", "arguments": {
    "assembly_name": "MyAssembly",
    "type_full_name": "MyNamespace.MyClass",
    "member_kind": "method",
    "member_name": "InternalHelper",
    "new_visibility": "public"
}}

{ "tool": "save_assembly", "arguments": {
    "assembly_name": "MyAssembly",
    "output_path": "C:\\patched\\MyAssembly.dll"
}}

在已知地址读取进程内存

{ "tool": "read_process_memory", "arguments": {
    "address": "0x7FFE00001000",
    "size": 256
}}

打开一个受ConfusedEx保护的EXE文件并将其删除

1. scan_pe_strings  assembly_name=MyApp  → confirm it's packed (few readable strings)
2. unpack_from_memory  exe_path=C:\MyApp.exe  output_path=C:\MyApp_unpacked.exe
3. detect_obfuscator  file_path=C:\MyApp_unpacked.exe  → identify remaining obfuscation
4. deobfuscate_assembly  file_path=C:\MyApp_unpacked.exe  output_path=C:\MyApp_clean.dll

修补反调试存根并保存干净的二进制文件

1. list_pinvoke_methods  assembly=MyApp  type=AntiDebugClass
   → finds "CheckRemoteDebuggerPresent" → kernel32.dll
2. patch_method_to_ret  assembly=MyApp  type=AntiDebugClass  method=CheckRemoteDebuggerPresent
3. save_assembly  assembly=MyApp  output_path=C:\MyApp_patched.exe

从磁盘或正在运行的进程加载程序集

// Load a .NET DLL from disk
{ "tool": "load_assembly", "arguments": {
    "file_path": "C:\\dump\\MyApp_unpacked.dll"
}}

// Load a raw memory-layout dump (VAs instead of file offsets)
{ "tool": "load_assembly", "arguments": {
    "file_path": "C:\\dump\\MyApp_memdump.bin",
    "memory_layout": true
}}

// Dump from a running process and load directly into dnSpy
{ "tool": "load_assembly", "arguments": {
    "pid": 1234,
    "module_name": "MyPlugin.dll"
}}

关闭阻止调试会话的对话框

{ "tool": "list_dialogs" }
// → [1] Title: "Error de depuración"
//       Hwnd: 1A2B3C  |  Type: Win32 (#32770)
//       Message: "No se puede continuar la operación."
//       Buttons: Aceptar, Cancelar

{ "tool": "close_dialog", "arguments": { "hwnd": "1A2B3C", "button": "aceptar" } }
// → Clicked 'Aceptar' in dialog 'Error de depuración'.

查找可疑类型的所有调用者和用法

{ "tool": "find_who_uses_type", "arguments": {
    "assembly_name": "MyAssembly",
    "type_full_name": "MyNamespace.ObfuscatedLicenseChecker"
}}

{ "tool": "find_who_writes_field", "arguments": {
    "assembly_name": "MyAssembly",
    "type_full_name": "MyNamespace.ObfuscatedLicenseChecker",
    "field_name": "isValid"
}}

______________________________________________________________________

建筑

设计原则

• dnSpy.MCP.Server 是dnSpy内部托管的扩展；它不会分叉或嵌入自定义dnSpy树
• MCP功能在内部实现 dnSpy.MCP.Server 无需修补dnSpy源
• 只有当HoLLy启发的功能可以作为稳定、可序列化、非UI MCP工具公开时，才会进行移植
• Echo集成仅限于可以为LLM干净序列化的稳定托管CFG子集

目录元数据

工具目录现在公开了旨在提高客户端可发现性的元数据：

• category
• hidden_by_default
• is_legacy
• preferred_replacement
• notes

tools/list 隐藏标记的工具 hidden_by_default 除非客户端明确请求完整目录。 list_tools 在band中镜像相同的行为并返回相同的目录元数据。

______________________________________________________________________

项目结构

dnSpy.MCP.Server/
├── dnSpy.MCP.Server.csproj   # Multi-target: net48 + net10.0-windows
├── CHANGELOG.md
├── README.md
├── RELEASE_NOTES.md
└── src/
    ├── Application/
    │   ├── AssemblyTools.cs         # Assembly & type listing
    │   ├── TypeTools.cs             # Type internals + IL
    │   ├── EditTools.cs             # Metadata editing, method patching
    │   ├── DebugTools.cs            # Debugger integration
    │   ├── DumpTools.cs             # Memory dump & PE tools
    │   ├── MemoryInspectTools.cs    # Local variable inspection
    │   ├── UsageFindingCommandTools.cs  # IL usage analysis
    │   ├── CodeAnalysisHelpers.cs   # Call-graph & dependency analysis
    │   ├── De4dotTools.cs           # de4dot deobfuscation (all builds)
    │   ├── SkillsTools.cs           # Skills knowledge base (MD + JSON)
    │   ├── ScriptTools.cs           # Roslyn C# scripting
    │   ├── WindowTools.cs           # Win32/WPF dialog management
    │   └── McpTools.cs              # Tool registry & routing
    ├── Communication/
    │   └── McpServer.cs             # streamable HTTP server
    ├── Contracts/
    │   └── McpProtocol.cs           # DTO types
    ├── Helper/
    │   └── McpLogger.cs
    └── Presentation/
        ├── TheExtension.cs          # MEF export / entry point
        ├── ToolbarCommands.cs
        ├── McpSettings.cs
        └── McpSettingsPage.cs

______________________________________________________________________

配置

mcp-config.json

A. mcp-config.json 文件在首次运行时自动创建在MCP服务器DLL旁边。编辑它以更改网络或de4dot设置-- 无需重建.

{
  "host": "localhost",
  "port": 3100,
  "requireApiKey": false,
  "apiKey": "",
  "enableRunScript": false,
  "de4dotExePath": "",
  "de4dotSearchPaths": [],
  "de4dotMaxSearchDepth": 6
}

远程访问 --何时 host 是 "0.0.0.0" 或 "*"，HttpListener使用通配符绑定 +。这需要一次性URL ACL保留（以管理员身份运行）： `` netsh http add urlacl url=http://+:3100/ user=Everyone ` 然后将您的MCP客户端指向 http://:3100/mcp`.

编辑后 mcp-config.json，呼叫 reload_mcp_config 或重新启动dnSpy以应用更改。

验证服务器是否正在运行

# Windows (PowerShell)
Invoke-RestMethod http://localhost:3100

# Windows (cmd)
curl http://localhost:3100

# Check port is listening
netstat -ano | findstr :3100

______________________________________________________________________

故障排除

______________________________________________________________________

贡献

1. 分叉或分支 master
2. 在下实施您的更改 src/Application/ 或 src/Communication/
3. 在中注册新工具 McpTools.cs (GetAvailableTools + ExecuteTool 开关）
4. 构建于 dotnet build … --nologo --必须生产 0个错误，0个警告
5. 通过任何MCP客户端手动测试(list_tools 验证注册）
6. 提交一份PR，说明新工具及其参数

______________________________________________________________________

许可证

版权所有（C）2026@chichicaste。

根据GNU通用公共许可证第3版或您选择的任何更高版本进行许可。看 许可证 了解详情。