mcp-dotnet

俄语版本见下文 / Russian version below

这是一个小型模型上下文协议 (MCP) 服务器，允许 LLM 以 C# 形式读取 .NET 程序集。它是官方 ILSpy CLI (ilspycmd) 的轻量级封装，通过 stdio 公开，因此任何支持 MCP 的客户端都可以列出类型、反编译单个类、将整个程序集反编译为项目树，或在反编译后的源码中进行 grep 搜索。

为什么需要它

LLM 擅长阅读源代码，而不是原始的 IL 字节码。ILSpy 已经可以将 CIL 转换为忠实的 C# 代码，但从聊天代理中调用它很麻烦——你最终不得不手动调用 ilspycmd 并将输出粘贴回对话中。该服务器将此循环形式化：

• 首先使用 list-types，这样模型无需将数兆字节的反编译内容放入上下文中即可知道要查看哪个类型。

• 使用 decompile-type 进行针对性读取——一次一个完全限定的类。

• 当模型确实需要整个项目树时（例如在运行全项目 grep 之前），使用 decompile-assembly。

• search-source 会进行一次反编译，缓存输出，并在所有生成的 .cs 文件中进行 grep 搜索。后续搜索将重用缓存的树。

目标程序集永远不会被执行。一切都是静态的。

它还处理了现代常见的 .NET 6/7/8 单文件部署情况——将 path 指向已发布的 .exe，ILSpy 10+ 会自动解析嵌入的核心程序集。

Related MCP server: sharplens-mcp

工具

安装

# 1. ILSpy CLI (one-time, requires .NET SDK 6+)
dotnet tool install --global ilspycmd

# 2. This server
git clone https://github.com/beekamai/mcp-dotnet.git
cd mcp-dotnet
npm install
npm run build

如果 ilspycmd 不在 PATH 中，请将 ILSPYCMD 环境变量设置为其绝对路径。服务器还会自动检测 Windows 上的默认 %USERPROFILE%\.dotnet\tools\ilspycmd.exe 位置以及 POSIX 上的 ~/.dotnet/tools/ilspycmd 位置。

通过 stdio 将其连接到任何支持 MCP 的客户端：

your-mcp-client mcp add dotnet --scope user -- node /absolute/path/to/mcp-dotnet/dist/index.js

注意事项

• 所有工具都接受绝对路径。MCP 客户端和此服务器之间的工作目录差异很常见，因此服务器拒绝进行猜测。

• decompile-assembly 以及在全新程序集上的首次 search-source 可能需要几十秒到几分钟不等，具体取决于大小——超时时间为 10 分钟。

• search-source 默认将反编译后的树缓存到 <assemblyDir>/.mcp-dotnet-<assemblyName>/ 下。传递显式的 outDir 以控制位置，或删除缓存以强制重新反编译。

• 服务器将 ilspycmd 作为子进程运行，且从不暴露其 stdin。目标程序集的代码在任何时候都不会被执行。

许可证

MIT。

mcp-dotnet (RU)

Небольшой MCP-сервер, который даёт языковой модели возможность читать .NET-сборки как C#-исходники. Это тонкая обёртка над официальной консольной утилитой ILSpy (ilspycmd) поверх stdio: модель может получить список типов, декомпилировать один класс, развернуть всю сборку в дерево .cs-файлов или прогнать regex по исходнику.

Зачем это нужно

LLM хорошо читают исходный код и плохо — IL. ILSpy и так умеет превращать CIL в адекватный C#, но дёргать ilspycmd руками из чата неудобно — каждый раз shell-out и копипаст в контекст. Этот сервер формализует цикл:

• Сначала list-types, чтобы модель не тащила мегабайты декомпила в контекст ради того, чтобы выяснить какой класс ей нужен.

• decompile-type — точечно один полностью-квалифицированный тип.

• decompile-assembly — когда нужен весь проектный tree (например, чтобы потом сделать project-wide grep).

• search-source — декомпилирует один раз, кэширует результат и ищет regex по всем .cs. Повторные поиски используют кэш.

Целевую сборку никто не запускает. Всё статично.

Сервер также корректно работает с single-file deployment .NET 6/7/8 — указываешь path на опубликованный .exe, ILSpy 10+ сам находит встроенный основной assembly.

Тулы

Установка

# 1. ILSpy CLI (один раз, нужен .NET SDK 6+)
dotnet tool install --global ilspycmd

# 2. Сам сервер
git clone https://github.com/beekamai/mcp-dotnet.git
cd mcp-dotnet
npm install
npm run build

Если ilspycmd не попал в PATH — выставь переменную окружения ILSPYCMD с абсолютным путём. Сервер также автоматически находит дефолтные пути: %USERPROFILE%\.dotnet\tools\ilspycmd.exe на Windows и ~/.dotnet/tools/ilspycmd на POSIX.

Подключение к MCP-клиенту через stdio:

your-mcp-client mcp add dotnet --scope user -- node /абсолютный/путь/к/mcp-dotnet/dist/index.js

Заметки

• Все тулы принимают абсолютные пути. Рабочая директория MCP-клиента и сервера часто различаются, поэтому сервер ничего не угадывает.

• decompile-assembly и первый search-source на свежей сборке могут занимать от десятков секунд до нескольких минут — таймаут 10 минут.

• search-source кэширует декомпилированное дерево в <dir-сборки>/.mcp-dotnet-<имя-сборки>/. Если хочется в другое место — передай outDir явно. Удаление каталога заставит декомпилировать заново.

• ilspycmd запускается дочерним процессом, его stdin не пробрасывается. Код целевой сборки нигде не исполняется.

Лицензия

MIT。

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• decompile-assemblyA
• decompile-typeA
• list-typesA
• search-sourceA