Dnsoc MCP Kali

dnsoc mcp-kali——kali mcp服务器+VSCode协导客户端

一个轻量级的设置，用于运行 Kali Linux（VMware）上基于Python的模型上下文协议（MCP）服务器 并从连接到它 Windows上的VSCode 使用小型Python客户端。然后，VSCode Co-Pilot可以发送在Kali VM上执行的自然语言提示。

仅在您拥有或授权测试的机器和网络上使用此功能。

有关详细步骤，请访问上述网站：https://dnsoc.notion.site/Creating-MCP-Server-28a27f6eb2538011939ee22af00b13bb?source=copy_link

______________________________________________________________________

特性

• 在Kali Linux（VM）上运行的Python MCP服务器
• 通过连接的Windows VSCode客户端 mcp.json （副驾驶/标准驾驶）
• VSCode中的自然语言提示触发Kali上的自动命令
• 最少的手动配置；只有 mcp.json 文件需要本地路径/URL编辑
• 使用SonarQube分析代码（目前无错误）

______________________________________________________________________

需求

• python3
• aiohttp
• asyncio
• typing

安装依赖项（示例）：

python3 -m pip install aiohttp

______________________________________________________________________

快速开始

1.克隆并进入仓库

git clone 
cd dnsoc-mcp-kali

2.启动Kali MCP服务器（在Kali VM上）

在Kali VM上运行服务器脚本：

python3 kali_mcp_server.py --http --port 

如果你不通过港口， 8000 在项目中预先配置；确保在中使用相同的端口 mcp.json.

3.配置VSCode客户端（在Windows主机上）

1. 在VSCode中创建一个新文件夹并添加 windows_kali_mcp_client.py 里面。
2. 在该文件夹中创建一个 .vscode 子文件夹。
3. 添加 mcp.json 到 .vscode/ 并粘贴此内容，然后相应地更新路径、用户名、IP和端口：

{
    "servers": {
        "kali_mcp": {
            "type": "stdio",
            "command": "C:\\Users\\\\AppData\\Local\\Programs\\Python\\Python314\\python.exe",
            "args": [
                "C:\\Users\\\\Documents\\kali_mcp\\windows_kali_mcp_client.py",
                "http://192.168.1.7:8000"
            ]
        }
    }
}

注： 确保 command Python路径和 args 客户端脚本路径对于您的计算机是正确的。同时更新 http://: 指向网络中Kali VM IP和端口的URL。

______________________________________________________________________

文件夹结构

dnsoc-mcp-kali/
├─ kali_mcp_server.py
├─ windows_kali_mcp_client.py   # copy into your VSCode project folder on Windows
├─ README.md
└─ .vscode/
   └─ mcp.json                  # create this locally in your VSCode project and edit paths/URL

仅 .vscode/mcp.json 需要手动编辑。其他文件已准备好运行。

______________________________________________________________________

测试提示示例（来自VSCode）

配置并运行服务器+客户端后，通过VSCode Co-Pilot（或您正在使用的任何界面）使用这些提示。

1. Can you provide a list of tools available in the kali_mcp environment, along with their main use cases (e.g., scanning, exploitation)?

1. Run an Nmap basic ping scan (-sn) against example.com on the Kali Linux machine (IP: 192.168.1.7). Ensure the command is executed on the remote machine via SSH. Save the normal-format output to the desktop of the Kali machine (e.g., /home/kali/Desktop/example_scan.txt), and present a concise, nicely formatted summary of the results here in chat.

如果配置正确，服务器将执行命令并将结果返回给VSCode。

______________________________________________________________________

故障排除

• 服务器不可访问：确认Kali VM网络（仅桥接/主机）、防火墙，以及服务器和服务器中的端口是否匹配 mcp.json.

• 权限/路径错误：验证中的Python可执行路径和客户端脚本路径 mcp.json.

• 如果Co-Pilot/VCode未启动客户端，请尝试手动运行客户端脚本以查看日志：

  & "C:\Users\\AppData\Local\Programs\Python\Python314\python.exe" "C:\path\to\windows_kali_mcp_client.py" "http://:
"

______________________________________________________________________

安全与法律

仅在您拥有或具有明确测试权限的主机上使用此设置。在远程机器上执行命令可能具有破坏性；运行前检查命令。

______________________________________________________________________