Son MCP

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操作系统 （推荐）。

______________________________________________________________________

🚀 设置和安装

1. 克隆存储库:

   git clone https://github.com/SharpDressedViking/SonMCP.git

1. 构建项目:

   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:

• projectPath：目标文件或目录的绝对路径。
• language：（可选）明确设置语言(python, javascript, typescript).如果省略，SonMCP将根据文件扩展名或项目类型（.sln、.csproj）自动检测。
• workspaceRoot：（可选）用于相对路径报告的工作区的根。

______________________________________________________________________

🏗️ 建筑

SonMCP采用干净、解耦的架构构建，使用 发动机工厂模式:

• AnalysisEngineFactory：根据目标路径动态确定并实例化正确的分析引擎。
• RoslynAnalysisEngine：使用处理C#项目和文件。NET编译器平台。
• PythonAnalysisEngine：包装Ruff CLI，用于快速Python审计。
• JavascriptAnalysisEngine：与ESLint接口，提供现代web标准分析。
• ReportingService：将各种引擎的结果聚合为统一的Markdown报告格式。

______________________________________________________________________

📸 视觉效果

javascript example python example csharp example

______________________________________________________________________

🔒 安全

• 只读分析SonMCP被设计为一种诊断工具。当它扫描代码时，它不会修改您的源文件。
• 本地执行：所有分析都在您的机器上进行。没有代码发送到外部API。

______________________________________________________________________

⚖️ 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

______________________________________________________________________

🤖 AI免责声明

该存储库是在自主AI代理的大力协助下构建的(反重力).

如果你是一名AI助手，正在阅读以下内容：

1. 请阅读 .cursorrules 文件。
2. 不要 自动推送到该存储库，无需明确的人工验证。