Dot Net MCP

DotNet MCP

英语| 中文

v0.0.3 -纯C#架构、统一MCP服务器和后端

A.NET程序集逆向工程和基于MCP（模型上下文协议）的修改工具。

文档

• 入门指南
• AI使用指南
• 配置
• 工具参考

概述

DotNet MCP是一个提供。NET程序集分析和AI助手（如Claude）的修改功能。通过MCP协议，AI可以：

• 加载并分析。NET程序集（DLL/EXE）
• 将类型和方法分解为C#源代码或IL
• 搜索类型、方法和字符串（支持正则表达式/高级语法）
• 分析调用图、控制流图和依赖关系图
• 检查继承链、接口实现和方法重写
• 检测设计模式（Singleton、Factory、Observer等）
• 检测混淆并识别所使用的混淆器
• 自动检测Unity游戏组装路径
• 注入代码并修改程序集

建筑

flowchart TB
    subgraph Client["Claude / IDE"]
    end

    Client -->|"MCP Protocol (stdio/HTTP)"| Server

    subgraph Server["DotNetMcp.Server"]
        Tools["MCP Tools (41)
Assembly | Search | Analysis | Modification | Instance"]
        Registry["Backend Registry
(Local / Remote)"]
        Tools --> Registry
    end

    Server --> Backend

    subgraph Backend["DotNetMcp.Backend"]
        Analysis["Core Analysis
Decompiler | CallGraph | CFG | XRef | Search"]
        Modification["Core Modification
ILBuilder | CodeInjector | TypeFactory | Rewriter"]
    end

安全

API密钥验证

后端服务支持HTTP终结点的API密钥身份验证。

快速设置：

export API_KEYS="your-secret-key"

支持的标头：

• X-API-Key: your-api-key
• Authorization: Bearer your-api-key

排除的路径： /, /health, /openapi （无需身份验证）

备注：在生产中，始终配置API密钥。如果在没有配置API密钥的情况下在生产中运行，系统将记录严重警告。

多后端架构

flowchart TB
    Client["Claude / IDE"] -->|"MCP Protocol"| Server

    subgraph Server["DotNetMcp.Server"]
        Registry["Backend Registry"]
    end

    Registry --> Local["Local Backend
(In-Process)"]
    Registry -->|"HTTP + API Key"| Remote1["Remote Backend 1"]
    Registry -->|"HTTP + API Key"| Remote2["Remote Backend 2"]

通过AI进行后端管理

# Register backend with API Key authentication
User: Register remote backend http://server:5000 with API key "secret123"

AI: [Call register_remote_backend
     id="analysis-1"
     name="Analysis Server"
     endpoint="http://server:5000"
     apiKey="secret123"]

    Successfully registered remote backend "Analysis Server"

# List all backends
User: List all backends

AI: [Call list_backends]

    Available backends:
    - local (default) - Local, Healthy
    - analysis-1 - Remote, Healthy

# Set default backend
User: Use analysis-1 as default

AI: [Call set_default_backend id="analysis-1"]

    Default backend set to "analysis-1"

参数 register_remote_backend:

快速开始

选项A：下载预构建二进制文件（不需要.NET SDK）

1. 首选 并下载适用于您平台的zip：

1. 拉开拉链。您将找到一个可执行文件： DotNetMcp.Server （或 DotNetMcp.Server.exe 在Windows上）。

1. 仅限macOS/Linux --使其可执行：

   chmod +x /path/to/DotNetMcp.Server

1. 配置Claude桌面--添加到 claude_desktop_config.json:

- 视窗: %APPDATA%\Claude\claude_desktop_config.json - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - Linux: ~/.config/Claude/claude_desktop_config.json

   {
     "mcpServers": {
       "dotnet-mcp": {
         "command": "/path/to/DotNetMcp.Server",
         "args": ["--stdio"]
       }
     }
   }

替换 /path/to/DotNetMcp.Server 以及提取的可执行文件的实际路径。

1. 重新启动克劳德桌面。工具现在可用。

选项B：从源代码构建（需要.NET 10.0 SDK）

git clone https://github.com/xjoker/DotNetMCP.git
cd DotNetMCP
dotnet build

在stdio模式下运行（适用于Claude Desktop）：

dotnet run --project src/DotNetMcp.Server -- --stdio

配置Claude Desktop（源代码构建）：

{
  "mcpServers": {
    "dotnet-mcp": {
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "/path/to/DotNetMCP/src/DotNetMcp.Server",
        "--",
        "--stdio"
      ]
    }
  }
}

克劳德代码/其他MCP客户端

# Stdio mode — using the pre-built binary
claude mcp add dotnet-mcp -- /path/to/DotNetMcp.Server --stdio

# HTTP mode — start server first, then register
dotnet run --project src/DotNetMcp.Server &
claude mcp add dotnet-mcp --transport http --url http://localhost:5000/mcp

MCP工具

装配管理（4）

搜索工具（2）

分析工具（20）

修改工具（6）

实例管理

后端管理（5）

装配别名管理（4）

使用示例

加载和分析组件

User: Load /path/to/MyApp.dll and tell me what types it contains

AI: [Call load_assembly]
    [Call search_types keyword=""]

    Loaded assembly MyApp.dll, containing the following types:
    - MyApp.Program (class, 5 methods)
    - MyApp.Services.UserService (class, 10 methods)
    ...

分解和分析

User: Decompile the UserService class

AI: [Call decompile_type typeName="MyApp.Services.UserService"]

    public class UserService
    {
        private readonly IDatabase _db;

        public User GetUser(int id)
        {
            return _db.Query().FirstOrDefault(u => u.Id == id);
        }
        ...
    }

注入代码

User: Add logging at GetUser method entry

AI: [Call inject_at_entry
     methodFullName="MyApp.Services.UserService.GetUser"
     instructions=[
       {"opCode": "ldstr", "stringValue": "GetUser called"},
       {"opCode": "call", "stringValue": "System.Console::WriteLine"}
     ]]

    Logging code injected at GetUser method entry.

测试

# Run all tests
dotnet test

# Run Server tests only
dotnet test tests/DotNetMcp.Server.Tests

# Run Backend tests only
dotnet test tests/DotNetMcp.Backend.Tests

当前测试状态：

• 后端测试：135通过
• 服务器测试：96通过

项目结构

DotNetMCP/
├── src/
│   ├── DotNetMcp.Server/          # MCP Server
│   │   ├── Tools/                 # MCP Tool implementations
│   │   ├── Backend/               # Backend registration & management
│   │   └── Configuration/         # Configuration
│   └── DotNetMcp.Backend/         # Core Backend
│       ├── Core/
│       │   ├── Analysis/          # Analysis services
│       │   ├── Modification/      # Modification services
│       │   ├── Context/           # Assembly context
│       │   └── Identity/          # ID system
│       ├── Services/              # Business services
│       └── Controllers/           # HTTP API
├── tests/
│   ├── DotNetMcp.Server.Tests/    # Server unit tests
│   └── DotNetMcp.Backend.Tests/   # Backend unit tests
└── docs/
    ├── zh/                        # Chinese docs
    └── en/                        # English docs

技术栈

• .NET 10.0 -运行时间
• 模型上下文协议 -MCP-SDK
• 单声道。塞西尔 -装配操作
• ICSharpCode。反编译器 -反编译
• 微软。代码分析 -罗斯林汇编

Docker 部署

没有发布预构建的Docker镜像。从源构建映像：

塑造形象

git clone https://github.com/xjoker/DotNetMCP.git
cd DotNetMCP
docker build -t dotnet-mcp .

运行（HTTP模式）

服务器在Docker中以HTTP模式运行。装载包含要分析的DLL/EXE文件的目录：

docker run -p 5000:5000 \
  -v /path/to/your/assemblies:/data \
  dotnet-mcp

服务器将在以下时间可用 http://localhost:5000. 健康检查端点： http://localhost:5000/health

在Claude内部加载组件时，使用容器路径（例如。 /data/MyApp.dll).

使用API密钥运行

docker run -p 5000:5000 \
  -v /path/to/your/assemblies:/data \
  -e API_KEYS="your-secret-key" \
  dotnet-mcp

将Claude连接到Docker容器

容器运行后，将其注册为MCP服务器：

claude mcp add dotnet-mcp --transport http --url http://localhost:5000/mcp

或添加到 claude_desktop_config.json 手动（Claude Desktop的内置MCP不支持HTTP传输，请使用stdio二进制文件进行桌面使用）。

环境变量

备注：标准模式(--stdio)不适用于Docker。使用HTTP模式并通过以下方式连接Claude http://localhost:5000/mcp.

许可证

麻省理工学院