RR MCP Server for .NET Analysis

用于 .NET 分析的 RR MCP 服务

一个通用的 MCP 服务，可使用 PowerShell 脚本从任何 .NET 解决方案中提取 .NET 接口、OpenAPI 和数据（模型／实体／枚举）信息。 目标是在不暴露项目内容的情况下，向 AI 提供大型项目的结构和抽象信息。

后续将添加更多用于 .NET 解决方案 AI 管理和自动化的工具。

依赖项

• ModelContextProtocol — 用于 Model Context Protocol 服务和客户端的官方 C# SDK。GitHub

功能

• 从任何 .NET 解决方案中提取模型、实体、枚举和接口
• 为 AI Agent 提供完整的项目结构／上下文，避免重复生成
• 可直接与 Cursor、Copilot、Claude 或任何兼容 MCP 的工具搭配使用
• 速度快，支持缓存；输出整洁（无 stdout 噪声），并将完整日志写入文件
• 自动发现脚本，支持相对／绝对 .sln 路径
• 跨平台（Windows、macOS、Linux），需要 PowerShell 7+

输出格式示例

数据工具（GetData）

• 模型／实体：

  {
    "n": "UserModel",
    "b": "BaseModel",
    "p": { "Id": "string", "Name": "string", "Age": "int" },
    "prj": "My.Project.Namespace"
  }
  

  • 任何以 *Entity 为后缀的类都会作为实体包含在内（不要求基类）。
• 枚举：

  {
    "n": "StatusType",
    "m": { "Unknown": 0, "Active": 1, "Inactive": 2 },
    "prj": "My.Project.Namespace"
  }
  

接口工具（GetInterfaces）

• 接口：

  {
    "n": "IMyService",
    "b": "IBaseService",
    "d": "Service for handling user operations.",
    "m": [
      "Task DoWork(string arg);",
      { "s": "Task<int> GetCount();", "d": "Gets the count." }
    ],
    "prj": "My.Project"
  }
  

  • n：接口名称
  • b：基接口（可选）
  • d：接口文档（可选）
  • m：方法（签名字符串，或带文档的对象）
  • prj：项目名称

命名约定

• 模型：*Model
• 实体：*Entity
• 枚举：*Type
• 接口：I*Service、I*Repository 等

手动运行脚本（用于预热缓存或调试）

你可以直接运行 PowerShell 脚本来预热缓存或调试输出。请从仓库根目录或 RR.MCP 目录运行：

接口：

pwsh -File RR.MCP/GetInterfacesPwsh.ps1 -SolutionFile MySolution.sln

数据（模型／实体／类型）：

pwsh -File RR.MCP/GetDataPwsh.ps1 -SolutionFile MySolution.sln

• 在 Windows、macOS 或 Linux 上，请确保 pwsh（PowerShell 7+）已添加到 PATH。
• 如有需要，可以指定其他解决方案文件。
• 输出将写入 .cache/，日志将写入 mcp_debug.log／mcp_data_debug.log。

要求

• .NET 9.0 SDK 或更高版本
• PowerShell 7.0+（pwsh 必须设置在 PATH 系统变量中）

设置

1. 克隆并构建

   git clone
   cd RR.MCP
   dotnet build
   

2. 配置 MCP 客户端 添加一个 stdio MCP 服务条目，例如：

   {
     "mcpServers": {
       "rr-mcp": {
         "command": "dotnet",
         "args": ["run", "--project", "<absolute-path-to>/RR.MCP/RR.MCP.csproj"]
       }
     }
   }
   

   • 服务将自动注册所有可用工具（接口、数据等）。

3. 使用 只需为你的 Agent 添加以下规则，即可调用这些工具：

   • 调用 GetInterfaces 工具提取接口／OpenAPI 信息。
   • 调用 GetData 工具提取所有模型、实体和类型（枚举）及其结构。
   • 将 .sln 文件的路径作为 solutionFile 参数传入（可以是绝对路径，也可以是相对于服务工作目录的路径）。

日志与调试

• 所有 C# 错误都会记录到输出目录中的 mcp_errors.log。
• 所有 PowerShell 脚本活动和错误都会记录到脚本所在目录的 mcp_debug.log（接口）和 mcp_data_debug.log（数据）。
• 如果使用低于 7 的 PowerShell 版本运行，PowerShell 脚本会记录并返回错误。

PowerShell 脚本

• 脚本始终会复制到输出目录，并使用 pwsh -File ... 调用。
• 脚本会记录所有关键步骤、参数和错误。
• 如果找不到解决方案文件，或者未检测到数据，脚本会妥善处理并记录日志。
• 缓存按项目划分，并基于哈希值，以便快速重复运行。（大型项目首次运行会较慢，建议手动运行脚本）

自定义

• 要将其用于其他代码分析，请编辑 GetInterfacesPwsh.ps1 或 GetDataPwsh.ps1。
• 要添加更多工具，请在 C# 工具文件中添加新的 [McpServerTool] 方法。

与任意 AI IDE 集成

• 这个 MCP 服务完全通用，可与任何支持 MCP stdio 传输的 AI IDE 或工具集成。
• 工具会自动发现，并通过 OpenAPI 描述，便于使用。
• 不包含任何特定于 IDE 的逻辑；所有输出均符合协议要求。

---

Cursor 集成示例

如果使用 Cursor，请将以下内容添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "rr-mcp": {
      "command": "dotnet",
      "args": ["run", "--project", "<absolute-path-to>/RR.MCP/RR.MCP.csproj"]
    }
  }
}

贡献

• 欢迎提交 PR 和问题！
• 请确保所有输出均符合协议，且所有日志仅写入文件。

许可证

MIT