Kali Linux MCP Server

目前只是个玩具,只支持执行可以返回的命令,如burp suite和metasploit等不能进行界面和命令交互,metasploit倒是可以叫ai agent直接执行不进入命令交互模式,有时间弄得的哥们可以拿去加强一下 😜

kalilinuxmcp

kali linux mcp,pentest,penetration test

更新:

20250401更新: 新增简单的交互式处理

如何安装:

1: 首先要用ssh-keygen -t rsa做一个私钥和公钥,替换公钥到Dockerfile的,替换私钥到"C:\Users[Username].ssh\kali000",这里自行去src\index.ts里搜索"kali000"替换路径

'ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQCsoJo7WJIHDQgmEdKwm6IqS61xaGWa/OVVMCrMwcVh13xvYbAD7wdMufzNhWRxSso3SKvTHbQjIszvYQgkVFjRPiJW5vGCU0847CX0zZytGLnKpKWDZ5ccShMPlIxVuy2+WUQlKNL7f+w59PMX+3BLcikhtwk0xwG7tpS4kAtXHlrwt1B1vFj3CoF8rBofGJAahOuPvruRh9i1i73i5JJHJFeDdJVfNnY5/8HnBvtWtJzbsbmlyaTODfrDCeYZ32zxDZdsPVEls3RDsfgUadyC71mpXloJ8JTiUU37H5DY+xtIuz3XICwA7DsVm9jiKaSR96DZyogYxx+UKdrDsIH4JQwBNs3RDCX+t7ivKj75KkhhrW2X2h90EOjwQPQOhuVU2FtMXbWlfbZL5UwXGgA7Efe3N0ZzrKac+RGM6vY/jsnESgZaTayF/N/BysMpjI18xy6Y12CyPXVYsvF3v04d2XR1Fs5rduERjpot7o9N+i5FcoTfUb5WP5nVU9X0b2s= hack004@DESKTOP-H4HRI73'

2:因为是国内环境,docker里我加了使用主机的socks5代理,自行搜索来替换"192.168.31.110",还有dns服务器也强制用dns2socks转到了本地127.0.0.1使用socks5代理,可自行去Dockerfile里替换或者去掉

3:原始使用的"booyaabes/kali-linux-full"镜像,但是里面软件版本有点老,自行选择是否要执行以下操作更新(主要需要更新很久!)

wget -q -O - https://archive.kali.org/archive-key.asc | gpg --import 
curl -fsSL https://archive.kali.org/archive-key.asc | sudo gpg --dearmor -o /usr/share/keyrings/kali-archive-keyring.gpg 
sudo apt update && sudo apt full-upgrade -y 
(下载更新最新版kali linux的所有工具,注意很大很慢)sudo apt install kali-linux-everything -y 
如果只需更新单独的软件,就无需执行4因为要很久,例如sudo apt install wpscan 
我自己倒是完成了最新更新,但是容器太大了几十G就不传了,需要的自行操作就行了```

4:(编译MCP),先npm install后直接npm run build,得到build目录,核心是index.js

5:(编译Docker镜像),

1:编译镜像:"docker build -t kali-pentest-mcp ."
2:部署镜像:"docker run --name kali-container -d --privileged -p 2222:22 kali-pentest-mcp"

6:安装MCP:

"kali-pentest-mcp-server": {
  "command": "node",
  "args": ["D:/kalimcp/build/index.js"],
  "env": {}
}

注意事项:

1: 每次重启docker后记得刷新MCP,因为可能SSH连接会断开

参考项目:

https://github.com/weidwonder/terminal-mcp-server

效果展示:

2 injection:

3: Web shell upload via Content-Type restriction bypass

MCP实时命令输出查看器使用指南

概述

这个实时查看器解决了在Cursor等AI工具中执行长时间命令时看不到实时输出的问题。通过WebSocket技术，您可以在浏览器中实时监控命令执行进度。

快速开始

1. 启动实时查看器

Windows用户：

# 双击运行
start-realtime-viewer.bat

# 或者手动运行
cd realtime-viewer
npm install
npm start

Linux/Mac用户：

cd realtime-viewer
npm install
npm start

2. 打开Web界面

启动后，在浏览器中访问：

http://localhost:3000

3. 启用MCP服务器的实时推送

在Cursor或其他AI工具中，使用以下命令启用实时推送：

configure_realtime_viewer action=enable

或者配置自定义查看器URL：

configure_realtime_viewer action=configure viewer_url=http://localhost:3000

4. 执行命令并查看实时输出

现在当您执行交互式命令时，输出将实时显示在Web界面中：

start_interactive_command command="nmap -sS -O 192.168.1.1"

功能特性

Web界面功能

📊 会话列表 - 左侧显示所有活跃的命令会话
📺 实时输出 - 右侧显示选中会话的实时命令输出
🔄 自动滚动 - 可选的自动滚动到最新输出
🎨 VS Code风格 - 深色主题，类似VS Code的界面
📱 响应式设计 - 支持不同屏幕尺寸

MCP工具命令

查看实时推送状态

configure_realtime_viewer action=status

启用实时推送

configure_realtime_viewer action=enable

禁用实时推送

configure_realtime_viewer action=disable

配置查看器URL

configure_realtime_viewer action=configure viewer_url=http://localhost:3000

使用场景

1. 网络扫描

start_interactive_command command="nmap -sS -p- 192.168.1.0/24"

在Web界面中实时查看扫描进度和结果。

2. 漏洞扫描

start_interactive_command command="nikto -h http://target.com"

实时监控漏洞扫描的发现过程。

3. 密码破解

start_interactive_command command="hydra -l admin -P /usr/share/wordlists/rockyou.txt ssh://192.168.1.100"

实时查看密码破解尝试的进度。

4. 数据库操作

start_interactive_command command="mysql -u root -p"

在Web界面中查看SQL查询的执行结果。

环境变量配置

您可以通过环境变量配置MCP服务器：

# 启用实时推送（默认禁用）
set REALTIME_PUSH_ENABLED=true

# 配置查看器URL（默认 http://localhost:3000）
set REALTIME_VIEWER_URL=http://localhost:8080

# 重新启动MCP服务器
npm run build
npm start

故障排除

1. 连接问题

确保实时查看器服务器正在运行（http://localhost:3000）
检查防火墙设置
确认端口3000未被其他程序占用

2. 输出不显示

确认已启用实时推送：configure_realtime_viewer action=status
检查MCP服务器日志中的错误信息
确认命令是通过start_interactive_command启动的

3. 性能问题

对于输出量很大的命令，系统会自动缓冲输出以减少网络请求
可以通过清空输出按钮清理界面
关闭不需要的会话以释放资源

技术架构

┌─────────────────┐    HTTP/WebSocket    ┌──────────────────┐
│   MCP Server    │ ──────────────────► │ Realtime Viewer  │
│                 │                      │                  │
│ - CommandExecutor│                      │ - Express Server │
│ - RealtimePusher │                      │ - WebSocket      │
│ - SSH Sessions  │                      │ - Web Interface  │
└─────────────────┘                      └──────────────────┘
        │                                          │
        │ SSH                                      │ Browser
        ▼                                          ▼
┌─────────────────┐                      ┌──────────────────┐
│   Kali Linux    │                      │   Web Browser    │
│                 │                      │                  │
│ - Security Tools│                      │ - Real-time UI   │
│ - Command Line  │                      │ - Session Mgmt   │
└─────────────────┘                      └──────────────────┘

安全注意事项

本地使用 - 实时查看器默认只监听localhost，不对外网开放
无认证 - 当前版本没有身份验证，请勿在生产环境使用
敏感信息 - 命令输出可能包含敏感信息，请注意保护
网络安全 - 如需远程访问，请配置适当的网络安全措施

更新日志

v1.0.0

初始版本发布
支持实时命令输出显示
WebSocket通信
多会话管理
VS Code风格界面

Deploy Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

A tool that allows penetration testing through Kali Linux commands executed via a Multi-Conversation Protocol server, supporting security testing operations like SQL injection and command execution.

Related MCP Servers

MCP Server Pentest
9olidity
A
security
A
license
A
quality
A security testing tool that enables automated vulnerability detection including XSS and SQL injection, along with comprehensive browser interaction capabilities for web application penetration testing.
Last updated -
12
521
20
MIT License
Pentest MCP
DMontgomery40
A
security
A
license
A
quality
A Model Context Protocol server that integrates essential penetration testing tools (Nmap, Gobuster, Nikto, John the Ripper) into a unified natural language interface, allowing security professionals to execute and chain multiple tools through conversational commands.
Last updated -
9
38
86
MIT License
awsome_kali_MCPServers
VERMAXVR
-
security
A
license
-
quality
A collection of MCP servers for Kali Linux that empower AI Agents in reverse engineering and security testing, providing network analysis, target sniffing, traffic analysis, binary understanding, and automation capabilities.
Last updated -
23
Apache 2.0
Pentest Tools MCP Server
ch1nhpd
-
security
F
license
-
quality
An MCP server that integrates various penetration testing tools, enabling security professionals to perform reconnaissance, vulnerability scanning, and API testing through natural language commands in compatible LLM clients like Claude Desktop.
Last updated -
4

View all related MCP servers