Csharp Language Server

csharp语言mcp

通过MCP（模型上下文协议）为AI编码代理提供C#代码智能服务器，由Roslyn提供支持。

为什么使用这个？

使用C#的AI编码代理将代码视为文本——读取整个文件，查找模式，猜测类型。这对于动态语言来说还可以，但C#代码库会反击：深度类型层次结构、跨项目引用、泛型、隐式用法、分部类。一名武装特工 grep 正在盲目飞行。

csharp语言mcp 为代理提供了与IDE相同的智能——由Roslyn编译器平台提供支持：

C#导航

纽吉特

特工们正在合作。NET需要找到包，了解它们的API，并阅读文档。此服务器允许代理直接访问本地NuGet缓存中的真实程序集元数据和XML文档，该缓存以JSON形式构建，大小适合LLM上下文窗口。

Roslyn与文本搜索有何不同？

罗瑟琳 编译 你的代码。它解析类型、绑定符号并理解整个解决方案图。当代理询问“谁执行”时 IRepositoryRoslyn给出了真正的答案，而不是一个错过其他项目中实现或包含注释和字符串错误匹配的正则表达式近似值。

这对C#来说最重要，因为：

• 多项目解决方案 --引用、共享接口和NuGet包创建了文本搜索无法遵循的依赖关系图
• 丰富型系统 --泛型、继承、隐式转换和扩展方法对grep不可见
• 横切图案 --依赖注入、接口隔离和CQRS意味着符号的定义和使用很少在同一个文件中

需求

• .NET 9 SDK（包括MSBuild）

快速开始

MCP客户端配置

克劳德代码：

# Analyze the current directory
claude mcp add csharp -- dotnet run --project /src/CsharpMcp

# Analyze a specific project
claude mcp add csharp -- dotnet run --project /src/CsharpMcp -- 

替换 `` 带有此仓库克隆的路径。

其他MCP客户端（Cline等）：

{
  "mcpServers": {
    "csharp": {
      "command": "dotnet",
      "args": ["run", "--project", "/src/CsharpMcp", "--", "[your-csharp-repo]"]
    }
  }
}

或者使用已发布的二进制文件：

{
  "mcpServers": {
    "csharp": {
      "command": "/CsharpMcp",
      "args": ["[your-csharp-repo]"]
    }
  }
}

选项

多个实例 --使用 --name 和 --description 在每个repo运行一个服务器时区分服务器：

{
  "mcpServers": {
    "csharp-api": {
      "command": "/CsharpMcp",
      "args": ["--name", "csharp-api", "--description", "API layer", ""]
    },
    "csharp-core": {
      "command": "/CsharpMcp",
      "args": ["--name", "csharp-core", "--description", "Core domain", ""]
    }
  }
}

服务器发现所有 .csproj 根路径下的文件，并将它们加载到单个Roslyn工作区中。所有职位均为 1-索引 （第1行第1列=第一个字符）。

工具（共21个）

质量热点

这 quality_hotspots 该工具通过加权三个质量维度来识别需要重构的代码：

• 可维护性 --MI、圈复杂度、LOC、耦合
• 重复 --精确、重命名和语义代码克隆
• 间接 --通过深层调用链实现隐藏耦合

默认权重大致相等（每个≈0.33）。覆盖权重以关注特定问题。

跟踪之前/之后：

1. 呼叫 quality_hotspots(snapshotLabel: "before") 在会话开始时
2. 进行更改
3. 呼叫 quality_hotspots(compareToSnapshot: "before") --显示每种类型的增量

ISO 5055支持（部分）

这 generate_iso5055_report 该工具提供了对 ISO/IEC 5055 自动化源代码质量标准。它根据四个ISO 5055质量特征分析您的解决方案：

• 安全 --检测CWE映射的漏洞（例如SQL注入、路径遍历）
• 可靠性 --检测易出现缺陷的模式（例如空解引用、空捕获块）
• 性能效率 --检测资源浪费模式
• 可维护性 --检测过于复杂或不透明的代码（例如深度嵌套、幻数）

该报告包括违规计数、每个KLOC的违规、每个类别的通过/失败、覆盖的CWE ID以及每个违规文件路径，并附有修复建议。

类别和当前覆盖范围：

限制： 这不是SAST的替代品。依赖于Taint分析的CWE（SQL注入、XSS、命令注入）需要专用工具，如CodeQL或Semgrep。报告包括 CoveredCweIds 因此消费者确切地知道哪些CWE在范围内。

配置CLAUDE.md

为了充分利用此服务器，请将以下说明添加到您的项目中 CLAUDE.md 文件：

## C# Code Intelligence

Always prefer csharp MCP tools over grep/bash/find for C# code:
- Use `get_definition` instead of grepping for class/method definitions
- Use `get_references` instead of grepping for usages
- Use `find` instead of find/grep for locating symbols
- Use `get_diagnostics` instead of running `dotnet build` to check errors
- Use `get_outline` instead of reading entire files to understand structure
- Use `get_hover` to check types instead of guessing from context

## Code Quality Tracking
- At the START of each coding session, call `quality_hotspots(snapshotLabel: "before")` to capture a baseline
- At the END of each session (before committing), call `quality_hotspots(compareToSnapshot: "before")` to review quality impact
- If quality_hotspots shows degraded types, address them before finishing

为什么需要这个？ AI代理默认使用熟悉的工具，如 grep, find，以及 cat如果没有明确的指令，即使MCP工具可用，他们也会忽略它们——浪费令牌读取整个文件并产生不太准确的结果。这 CLAUDE.md 指令会覆盖此默认行为。

构建

dotnet build src/CsharpMcp.sln

测试

dotnet test src/CsharpMcp.sln

许可证

麻省理工学院