README.md•5.01 kB
# Prowler MCP Server for Claude Desktop by Compler
This is an MCP server that analyzes Prowler security scan results.
## Features
-`get_latest_prowler_file`: Retrieve latest file information
-`analyze_prowler_results`: Detailed security analysis (now supports a file_preview_length parameter for controlling text preview length)
-`get_security_summary`: Security status summary
-`get_prowler_reports_list`: Retrieve a list of Prowler report files.
-`get_file_content`: Retrieve the content of a specified file.
## Structure
```
compler-mcp-claude_desktop/
├── src/
│ └── prowler_mcp_server.py # Main MCP server
├── config/
│ └── claude_desktop_config.json # Claude Desktop settings >> Due to config conflict, using fastmcp's own functionality. (fastmcp install claude-desktop src\prowler_mcp_server.py:mcp)
├── logs/ # Log files
├── requirements.txt # Python dependencies
├── run.bat # Execution script
└── README.md # This file
```
## Installation and Execution
### 1. Install Dependencies
```bash
uv sync
```
### 2. Claude Desktop Configuration
Copy `config/claude_desktop_config.json` content to Claude Desktop settings:
```
%APPDATA%\Claude\claude_desktop_config.json
```
#### claude_desktop_config.json
```json
{
"mcpServers": {
"Prowler Analyzer": {
"command": "{uv-path}/uv",
"args": [
"run",
"--with",
"fastmcp",
"--with",
"beautifulsoup4",
"--with",
"requests",
"fastmcp",
"run",
"{project-path}/src/prowler_mcp_server.py:mcp"
],
"env": {},
"transport": "stdio"
}
}
}
```
### 3. Test Execution
```bash
# Direct execution
python src\prowler_mcp_server.py
# Or execute with batch file
run.bat
```
### 4. Restart Claude Desktop
Completely close and restart Claude Desktop
## Analysis Target
Path: `./prowler-reports` (This directory is automatically created relative to the project root.)
Supported Formats: HTML, CSV, JSON, JSON-ASFF, and general text files.
Prowler ASFF results specialized analysis
## References (Additional needed)
-[Prowler Official Documentation](https://docs.prowler.com/projects/prowler-open-source/en/latest/tutorials/prowler-app/)
-[KISA-ISMS-P Compliance](https://hub.prowler.com/compliance/kisa_isms_p_2023_aws)
## Support
```
ye11oc4t@gmail.com or Discord re-tired
woohyun212@gmail.com or Discord a_b_normal
```
___
# Prowler MCP Server for Claude Desktop by Compler
Prowler 보안 점검 결과를 분석하는 MCP 서버입니다.
## 기능
- `get_latest_prowler_file`: 최신 파일 정보 조회
- `analyze_prowler_results`: 상세 보안 분석
- `get_security_summary`: 보안 상태 요약
## 구조
```
compler-mcp-claude_desktop/
├── src/
│ └── prowler_mcp_server.py # 메인 MCP 서버
├── config/
│ └── claude_desktop_config.json # Claude Desktop 설정 >> config 충돌로 인해 fastmcp 자체 기능 사용중. (fastmcp install claude-desktop src\prowler_mcp_server.py:mcp)
├── logs/ # 로그 파일들
├── requirements.txt # Python 의존성
├── run.bat # 실행 스크립트
└── README.md # 이 파일
```
## 설치 및 실행
### 1. 의존성 설치
```bash
uv sync
```
### 2. Claude Desktop 설정
`config/claude_desktop_config.json` 내용을 Claude Desktop 설정에 복사:
```
%APPDATA%\Claude\claude_desktop_config.json
```
#### claude_desktop_config.json
```json
{
"mcpServers": {
"Prowler Analyzer": {
"command": "{uv-path}/uv",
"args": [
"run",
"--with",
"fastmcp",
"--with",
"beautifulsoup4",
"--with",
"requests",
"fastmcp",
"run",
"{project-path}/src/prowler_mcp_server.py:mcp"
],
"env": {},
"transport": "stdio"
}
}
}
```
### 3. 테스트 실행
```bash
# 직접 실행
python src\prowler_mcp_server.py
# 또는 배치 파일로 실행
run.bat
```
### 4. Claude Desktop 재시작
Claude Desktop을 완전히 종료하고 다시 시작
## 분석 대상
- 경로: `./prowler-reports` (이 디렉토리는 프로젝트 루트를 기준으로 자동으로 생성됩니다.)
- 지원 형식: HTML, CSV, JSON, JSON-ASFF, 텍스트 파일
- Prowler ASFF 결과 특화 분석
## 참고 자료 (추가 필요)
- [Prowler 공식 문서](https://docs.prowler.com/projects/prowler-open-source/en/latest/tutorials/prowler-app/)
- [KISA-ISMS-P 컴플라이언스](https://hub.prowler.com/compliance/kisa_isms_p_2023_aws)
## 지원
```
ye11oc4t@gmail.com or Discord re-tired
woohyun212@gmail.com or Discord a_b_normal
```