mcp-dotnet

Русская версия ниже / Russische Version unten

Ein kleiner Model Context Protocol (MCP) Server, der es einem LLM ermöglicht, .NET-Assemblies als C# zu lesen. Es ist ein schlanker Wrapper um die offizielle ILSpy CLI (ilspycmd), der über stdio bereitgestellt wird, sodass jeder MCP-fähige Client Typen auflisten, eine einzelne Klasse dekompilieren, die gesamte Assembly in einen Projektbaum dekompilieren oder den dekompilierten Quellcode durchsuchen kann.

Warum gibt es das?

LLMs sind gut darin, Quellcode zu lesen, nicht rohen IL-Bytecode. ILSpy wandelt CIL bereits in getreues C# um, aber der Aufruf aus einem Chat-Agenten heraus ist umständlich – man muss manuell ilspycmd aufrufen und die Ausgabe zurück in das Gespräch kopieren. Dieser Server formalisiert diesen Ablauf:

• list-types zuerst, damit das Modell weiß, welchen Typ es betrachten soll, ohne ein Megabyte an Dekompilierung in den Kontext zu laden.

• decompile-type für gezieltes Lesen – eine voll qualifizierte Klasse nach der anderen.

• decompile-assembly, wenn das Modell wirklich den gesamten Projektbaum benötigt, z. B. vor der Durchführung eines projektweiten Grep.

• search-source dekompiliert einmal, speichert die Ausgabe zwischen und durchsucht alle resultierenden .cs-Dateien. Nachfolgende Suchen verwenden den zwischengespeicherten Baum wieder.

Die Ziel-Assembly wird niemals ausgeführt. Alles ist statisch.

Es handhabt auch den modernen Standardfall von .NET 6/7/8 Single-File-Deployments – geben Sie den path auf die veröffentlichte .exe an und ILSpy 10+ löst die eingebettete Core-Assembly automatisch auf.

Related MCP server: sharplens-mcp

Tools

Installation

# 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

Wenn ilspycmd nicht im PATH ist, setzen Sie die Umgebungsvariable ILSPYCMD auf den absoluten Pfad. Der Server erkennt auch automatisch den Standardpfad %USERPROFILE%\.dotnet\tools\ilspycmd.exe unter Windows und ~/.dotnet/tools/ilspycmd unter POSIX.

Verbinden Sie es mit einem beliebigen MCP-fähigen Client über stdio:

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

Hinweise

• Alle Tools akzeptieren absolute Pfade. Unterschiede im Arbeitsverzeichnis zwischen dem MCP-Client und diesem Server sind häufig, daher weigert sich der Server zu raten.

• decompile-assembly und die erste search-source auf einer neuen Assembly können je nach Größe zwischen zehn Sekunden und mehreren Minuten dauern – das Timeout beträgt 10 Minuten.

• search-source speichert den dekompilierten Baum standardmäßig unter <assemblyDir>/.mcp-dotnet-<assemblyName>/. Übergeben Sie ein explizites outDir, um den Speicherort zu steuern, oder löschen Sie den Cache, um eine erneute Dekompilierung zu erzwingen.

• Der Server führt ilspycmd als untergeordneten Prozess aus und legt dessen stdin niemals offen. Zu keinem Zeitpunkt wird Code aus der Ziel-Assembly ausgeführt.

Lizenz

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