项目简介
Squirrel 代码分析与报告系统是一个使用 Rust 构建的高性能应用后端,它通过 Machine Context Protocol (MCP) 实现客户端-服务器通信,旨在为 LLM 客户端提供代码分析、报告生成和洞察分析服务。该系统支持多种代码分析功能,并可通过 Web 界面进行任务提交、进度跟踪和报告下载。
主要功能点
- 代码分析: 支持安全扫描、性能分析、代码风格检查和最佳实践验证等多种代码分析功能。
- 报告生成: 能够生成 Markdown、HTML、PDF 和 JSON 等多种格式的分析报告。
- MCP 服务器: 基于 Machine Context Protocol 构建,提供标准化的上下文信息和功能接口,支持 LLM 客户端进行交互。
- Web 界面: 提供友好的 Web 界面,用于提交分析任务、监控任务进度、查看和下载报告。
安装步骤
- 安装 Rust 环境: 确保已安装最新稳定版本的 Rust 开发环境。
- 安装 PostgreSQL 数据库: 安装并运行 PostgreSQL 数据库 (版本 14.0 或更高)。
- 安装 OpenSSL 开发库: 确保安装了 OpenSSL 开发库。
- 克隆仓库: 使用 'git clone <仓库URL>' 命令克隆仓库到本地。
- 配置数据库: 创建一个新的 PostgreSQL 数据库 'code_analysis',并根据需要运行数据库迁移(如果已实现)。
- 配置环境: 复制 'config.example.toml' 文件为 'config.toml',并根据您的 PostgreSQL 设置编辑 'config.toml' 文件。
- 构建项目: 使用 'cargo build --release' 命令构建项目。
服务器配置
MCP 服务器配置主要通过命令行参数进行,无需复杂的 JSON 配置文件。
MCP 服务器启动命令 (command):
cargo run -p mcp -- server
参数 (args):
无特定启动参数。服务器默认监听配置在 'config.toml' 文件中指定。
配置信息 (JSON):
{ "server name": "Squirrel MCP Server", "command": "cargo run -p mcp -- server", "args": [], "description": "启动 Squirrel 代码分析 MCP 服务器", "notes": "服务器配置主要在 config.toml 文件中,启动命令无需额外参数。" }
基本使用方法
- 启动 Web 服务器: 运行 'cargo run -p web' 命令启动 Web 界面。
- 启动 MCP 服务器: 运行 'cargo run -p mcp -- server' 命令启动 MCP 服务器。
- 访问 Web 界面: 通过浏览器访问 'http://localhost:3000',即可使用 Web 界面提交代码分析任务和查看报告。
- LLM 客户端集成: LLM 客户端可以通过 JSON-RPC 协议与 MCP 服务器进行通信,利用服务器提供的资源、工具和 Prompt 模板进行更深入的代码分析和交互。具体 API 文档请参考 API.md。
信息
分类
开发者工具