项目简介

Brutalist MCP是一个基于Model Context Protocol构建的服务器，它协调多个本地CLI代理（Claude、Codex、Gemini）对代码库、架构设计和产品概念进行全面分析。

主要功能

• 代码质量分析：检查安全漏洞、性能问题和代码质量
• 架构评估：分析系统架构的扩展性、成本和操作复杂性
• 安全审计：识别认证、授权和攻击向量
• 产品概念验证：评估技术可行性和市场适应性
• 多视角对比：不同AI代理提供独立分析视角
• 实时进度跟踪：通过SSE传输支持流式事件和进度更新
• 分页支持：处理大型代码库的分析结果
• 对话延续：通过context_id支持连续对话和历史注入

安装步骤

1. 安装CLI代理（至少一个）

# Claude Code（推荐）
npm install -g claude

# Codex CLI
# 从GitHub安装：https://github.com/openai/codex-cli

# Gemini CLI
npm install -g @google/gemini-cli

2. 安装MCP服务器

根据您的IDE选择相应配置：

Claude Code：

claude mcp add brutalist --scope user -- npx -y @brutalist/mcp@latest

Codex配置： 在'~/.codex/config.toml'中添加：

[mcp_servers.brutalist]
command = "brutalist-mcp"

Cursor： 在'~/.cursor/mcp.json'中添加：

{
  "mcpServers": {
    "brutalist": {
      "command": "npx",
      "args": ["-y", "@brutalist/mcp@latest"
}

VS Code / Cline：

code --add-mcp '{"name":"brutalist","command":"npx","args":["-y","@brutalist/mcp@latest"]
}

Windsurf： 在'~/.codeium/windsurf/mcp_config.json'中添加：

{
  "mcpServers": {
    "brutalist": {
      "command": "npx",
      "args": ["-y", "@brutalist/mcp@latest"]
}

基本使用方法

安装完成后，您可以在AI助手中使用以下工具：

分析代码库

roast_codebase "/path/to/your/project"

验证安装

# 检查可用的CLI代理
cli_agent_roster()

主要分析工具

• 'roast_codebase' - 安全漏洞、性能问题、代码质量
• 'roast_idea' - 可行性、市场适应性、实施挑战
• 'roast_security' - 攻击向量、认证、授权
• 'roast_architecture' - 扩展性、成本、操作复杂性
• 'roast_cli_debate' - 多代理讨论不同技术视角
• 'roast_file_structure' - 目录组织、命名约定、结构
• 'roast_dependencies' - 版本冲突、安全漏洞、兼容性

配置说明

MCP客户端需要配置以下信息与服务器建立连接：

• server name: brutalist
• command: npx
• args: ["-y", "@brutalist/mcp@latest"