Hướng dẫn cài NMAP và Claude MCP

[dangquangminh]

Hướng dẫn Step-by-Step cài đặt Nmap vào Claude
Yêu cầu hệ thống

• Windows 10/11, macOS 10.15+, hoặc Ubuntu 18.04+
• Git đã cài đặt
• Node.js 18+ và npm
• Quyền Administrator/sudo

Bước 1: Cài đặt Nmap
Windows:

1. Tải từ https://nmap.org/download.html
2. Chạy file .exe với quyền Administrator
3. Test: nmap --version

Bước 2: Cài đặt Node.js
Windows:

1. Tải từ https://nodejs.org
2. Cài đặt file .msi
3. Test: node --version và npm --version

Bước 3: Clone repository từ GitHub
git clone https://github.com/PhialsBasement/nmap-mcp-server.git
cd nmap-mcp-server
Bước 4: Cài đặt dependencies
npm install
Bước 5: Test MCP server
npm start
Nếu thấy "MCP Server running" hoặc tương tự → OK Nhấn Ctrl+C để dừng
Bước 6: Cài đặt Claude Desktop

1. Tải từ https://claude.ai/download
2. Cài đặt bình thường
3. Đăng nhập tài khoản
4. Đóng Claude Desktop

Bước 7: Cấu hình Claude Desktop
Windows: Tạo/sửa file %APPDATA%\Claude\claude_desktop_config.json:
{
"mcpServers": {
"nmap": {
"command": "node",
"args": [
"C:\\Users\\YOUR_USERNAME\\Downloads\\nmap-mcp-server\\dist\\index.js"
]
}
}
}
Lưu ý: Thay [username] và đường dẫn thực tế đến thư mục nmap-mcp-server
Ví dụ:

Bước 8: Khởi động và test

1. Mở Claude Desktop
2. Đợi 15-20 giây để MCP server khởi động
3. Gửi tin nhắn: "Bạn có thể sử dụng Nmap không?"
4. Claude xác nhận → Thành công!
5. Test đầu tiên: "Quét cổng trên 127.0.0.1"

Tìm đường dẫn thư mục chính xác
Windows:
cd nmap-mcp-server
echo %cd%

Troubleshooting
Git không có sẵn:

• Windows: Cài Git từ https://git-scm.com

npm install bị lỗi:

• Chạy npm cache clean --force
• Xóa folder node_modules và chạy lại npm install

MCP server không kết nối:

• Kiểm tra đường dẫn trong config file
• Đảm bảo npm start chạy được trong terminal
• Restart Claude Desktop

Permission denied khi quét:

• Windows: Chạy Claude Desktop với quyền Administrator

Claude không nhận diện Nmap:

• Kiểm tra Nmap có trong system PATH
• Test nmap --version trong terminal
• Restart Claude Desktop sau khi cài Nmap

Commands test cơ bản
Sau khi setup thành công, test các lệnh:

1. Basic scan: "Quét cổng mở trên google.com"
2. Version scan: "Xác định dịch vụ trên 8.8.8.8"
3. Vulnerability scan: "Tìm lỗ hổng trên localhost"
4. Network discovery: "Tìm thiết bị trong mạng 192.168.1.0/24"

Kiểm tra cài đặt thành công
Checklist:

• [ ] nmap --version hiển thị phiên bản
• [ ] node --version hiển thị v18+
• [ ] git --version hiển thị version
• [ ] Repository clone thành công
• [ ] npm install hoàn thành không lỗi
• [ ] npm start chạy được MCP server
• [ ] Config file tạo đúng đường dẫn
• [ ] Claude Desktop restart sau config
• [ ] Claude phản hồi positive về Nmap capabilities
• [ ] Test scan đầu tiên thành công

Lưu ý bảo mật

• Chỉ quét trong môi trường lab được phép
• Không quét địa chỉ IP bên ngoài không được ủy quyền
• Tuân thủ các quy định về penetration testing
• Monitor logs để tracking các hoạt động scanning

Update MCP server
Để cập nhật phiên bản mới:
cd nmap-mcp-server
git pull origin main
npm install
Sau đó restart Claude Desktop. (Nam Dương - PKT VnPro)