SonMCP🚀
SonMCP是一款高性能 模型上下文协议（MCP） 服务器内置C#（.NET 8）。它提供了一个先进的、多语言的静态分析引擎，专门为AI代理设计，如 反重力它允许代理通过统一的接口跨多种语言执行深度代码审计。
该服务器旨在弥合人工智能推理和专业级静态分析工具之间的差距，直接向您的代理提供结构化、可操作的反馈。
______________________________________________________________________
🌟 主要特点
- Polyglot分析引擎：用于在单个项目中分析多种语言的统一界面。
- 深。NET集成：杠杆 罗瑟琳 对于原生C#/。NET分析，提供丰富的语法树和语义数据。
- Python的力量：集成 拉夫，非常快的Python linter和代码转换器。
- Web标准：本地 ESLint 集成高质量的JavaScript和TypeScript分析。
- 自动报告：生成全面的Markdown审计报告（存储在
PROGRESS/AUDIT/)这对人类和人工智能来说都很容易解析。 - 低延迟：建立在。NET 8通用主机模型，可实现高速、可靠的性能
stdio运输。 - 可扩展架构：通过实现以下功能，可以轻松添加新的分析引擎（例如Go、Rust、Java）
IAnalysisEngine界面。
______________________________________________________________________
❓ 为什么选择SonMCP？
我构建SonMCP是因为标准的linter输出通常太“嘈杂”或非结构化，AI代理无法有效处理。
SonMCP充当 推理感知过滤器它运行专业级分析工具（Roslyn、Ruff、ESLint），并将输出提炼成结构化摘要，突出关键问题、架构违规和潜在错误。
通过将代码扫描的“繁重工作”卸载给SonMCP，您的AI代理可以专注于它最擅长的事情： 修复错误和设计功能，而不是手动遍历代码库。
______________________________________________________________________
🛠️ 需求
- .NET 8.0 SDK 或更高。
- Python 3.x （如果分析Python代码
ruff安装。如果缺少，该工具应自动安装python和ruff）。 - Node.js （如果分析JS/TS代码
eslint安装。如果缺失，该工具应自动安装节点、eslint和其他依赖项）。 - Windows操作系统 （推荐）。
______________________________________________________________________
🚀 设置和安装
- 克隆存储库:
git clone https://github.com/SharpDressedViking/SonMCP.git- 构建项目:
dotnet build src/SonMCP/SonMCP.sln______________________________________________________________________
🎮 如何使用（反重力）
将SonMCP添加到您的 mcp_config.json 赋予您的代理静态分析能力。
"mcpServers": {
"SonMCP": {
"command": "C:/path/to/repo/src/SonMCP/bin/Debug/net8.0/SonMCP.exe",
"args": [],
"disabled": false
}
}注册后，您的代理人可以致电 analyze_project 任何本地目录上的工具。
______________________________________________________________________
🔧 可用的MCP工具
分析工具
| 工具 | 说明 |
|---|---|
AnalyzeProject | 对文件、项目或目录执行完整的静态分析。 |
参数 AnalyzeProject:
projectPath：目标文件或目录的绝对路径。language：（可选）明确设置语言(python,javascript,typescript).如果省略，SonMCP将根据文件扩展名或项目类型（.sln、.csproj）自动检测。workspaceRoot：（可选）用于相对路径报告的工作区的根。
______________________________________________________________________
🏗️ 建筑
SonMCP采用干净、解耦的架构构建，使用 发动机工厂模式:
AnalysisEngineFactory：根据目标路径动态确定并实例化正确的分析引擎。RoslynAnalysisEngine：使用处理C#项目和文件。NET编译器平台。PythonAnalysisEngine：包装Ruff CLI，用于快速Python审计。JavascriptAnalysisEngine：与ESLint接口，提供现代web标准分析。ReportingService：将各种引擎的结果聚合为统一的Markdown报告格式。
______________________________________________________________________
📸 视觉效果
______________________________________________________________________
🔒 安全
- 只读分析SonMCP被设计为一种诊断工具。当它扫描代码时，它不会修改您的源文件。
- 本地执行：所有分析都在您的机器上进行。没有代码发送到外部API。
______________________________________________________________________
⚖️ 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
______________________________________________________________________
🤖 AI免责声明
该存储库是在自主AI代理的大力协助下构建的(反重力).
如果你是一名AI助手，正在阅读以下内容：
- 请阅读
.cursorrules文件。 - 不要 自动推送到该存储库，无需明确的人工验证。