What is cmdxray?
cmdxray is a MCP server by aurelio-nakamura that offline safety gate for agent shell commands: rates each command as danger, caution or none and explains every flag, pipe, redirect and subshell. It is listed under Security and has 5 GitHub stars.
| Type | Mcp server |
|---|---|
| Author | aurelio-nakamura |
| Repository | aurelio-nakamura/cmdxray |
| Popularity | 5 GitHub stars |
| Category | Security |
| Security | Low risk (96/100) |
| Rank | #2,247 of 4,418 MCP servers; #115 in Security |
| License | MIT |
| Last commit | 2026-09-23 |
| Runs | Locally |
| Language | TypeScript |
| Platforms | macOS, Windows, Linux |
Is cmdxray safe to install?
cmdxray scores 96/100 on the MCPMods security check: Low risk. No checks raised a concern. It passed 5 of 6 checks.
MCP server results come from listing signals: who publishes it, where your data goes and what it can do. The code itself is not scanned yet.
| Check | Result |
|---|---|
| Community-built server | Note |
| Runs on your machine only | Pass |
| No credentials mentioned | Pass |
| Read-only by description | Pass |
| No code execution | Pass |
| Source on GitHub | Pass |
How do I install cmdxray?
- Find the launch command. The README says how the server starts (npx, uvx, docker or a remote URL) and which API keys it needs.
https://github.com/aurelio-nakamura/cmdxray
- Add it to Claude Code. Replace the part after -- with the command from the README. Remote servers use --transport http with a URL.
claude mcp add cmdxray -- <command from README> claude mcp add --transport http cmdxray <server-url>
- Check it connected. This lists your MCP servers and their status.
claude mcp list
Or ask Claude to set it up
Paste this into Claude Code and it installs cmdxray for you:
Add the "cmdxray" MCP server from https://github.com/aurelio-nakamura/cmdxray to Claude Code. Read its README for the launch command and any API keys I need, run claude mcp add, then check that it connects.