AI Tools
WorkflowIntermediate

mcp-xray

mcp-xray is an open-source security scanner and dynamic penetration testing tool released in July 2026 by Traceforce, a security-focused startup. This tool is designed to detect vulnerabilities in the Model Context Protocol (MCP) infrastructure, which acts as a bridge between large language model (LLM)-based AI agents and local data sources. Similar to how traditional web security scanners meticulously analyze web servers to identify vulnerabilities, mcp-xray verifies the configuration integrity of connected MCP servers and performs TLS

mcp-xray is an open-source security scanner and dynamic penetration testing tool released in July 2026 by Traceforce, a security-focused startup. This tool is designed to detect vulnerabilities in the Model Context Protocol (MCP) infrastructure, which acts as a bridge between large language model (LLM)-based AI agents and local data sources. Similar to how traditional web security scanners meticulously analyze web servers to identify vulnerabilities, mcp-xray scans for anomalies in real-time, including verifying the integrity of configurations on connected MCP servers, checking TLS certificates, detecting exposed loopback addresses, and identifying potential issues that may arise during tool calling.

In conventional agent development environments, LLMs often operate with vulnerabilities, such as potential for privilege abuse, remote code execution (RCE), or server-side request forgery (SSRF) attacks, as they autonomously execute tools. In particular, when multiple MCP servers are connected, if the tool description is ambiguously written, it can lead to a "confused deputy" problem, where the agent unintentionally executes unintended parameters or dangerous commands. mcp-xray differentiates itself from existing static analysis tools by going beyond static file inspection to dynamically generate intelligent vulnerability testing plans using LLMs and directly perform penetration testing, proactively identifying and defending against hidden threats in the agent ecosystem.

In the fields of biotechnology research and genomic analysis, scenarios are being actively explored where AI agents directly query sensitive patient data or high-value compound library databases to automate exploration. If researchers run the config-scan command of mcp-xray on a custom MCP server they have built for data retrieval, it can detect whether API secret keys for accessing remote databases are hardcoded in plain text within local configuration files and verify input/output vulnerabilities that could trigger path traversal attacks at a baseline level. Finally, the results of the penetration testing are output in the standard security report format (SARIF), allowing it to be integrated into the laboratory's internal security review process, enabling the rapid implementation of a secure research automation infrastructure.

💻 System Requirements

🧠RAM

0 (CPU 전용, LLM 스캐닝 및 모의 침투 분석 시 외부 LLM API 사용 가능하며 로컬 LLM 구동 시 8GB+ 권장)

💾Storage

약 100MB 미만 (바이너리 단독, 빌드 환경 구성 시 500MB 이내)

Installation

4-1. Quick Start

Go 1.25.4 이상이 설치된 환경에서 아래 단일 명령어로 컴파일 후 즉시 사용할 수 있습니다.

git clone https://github.com/traceforce/mcp-xray && cd mcp-xray && make install-dependencies && make all

4-2. 상세 설치

1. GitHub 레포지토리 복제 및 이동

git clone https://github.com/traceforce/mcp-xray cd mcp-xray

2. 필수 빌드 의존성 설치 (Go 개발 환경 필요)

make install-dependencies

3. 바이너리 컴파일 및 빌드

make all

4. 도움말 명령을 실행하여 설치 완료 여부 확인

./mcpxray --help

FAQ

What is mcp-xray?

mcp-xray is an open-source security scanner and dynamic penetration testing tool released in July 2026 by Traceforce, a security-focused startup. This tool is designed to detect vulnerabilities in the Model Context Protocol (MCP) infrastructure, which acts as a bridge between large language model (LLM)-based AI agents and local data sources. Similar to how traditional web security scanners meticulously analyze web servers to identify vulnerabilities, mcp-xray scans for anomalies in real-time, including verifying the integrity of configurations on connected MCP servers, checking TLS certificates, detecting exposed loopback addresses, and identifying potential issues that may arise during tool calling. In conventional agent development environments, LLMs often operate with vulnerabilities, such as potential for privilege abuse, remote code execution (RCE), or server-side request forgery (SSRF) attacks, as they autonomously execute tools. In particular, when multiple MCP servers are connected, if the tool description is ambiguously written, it can lead to a "confused deputy" problem, where the agent unintentionally executes unintended parameters or dangerous commands. mcp-xray differentiates itself from existing static analysis tools by going beyond static file inspection to dynamically generate intelligent vulnerability testing plans using LLMs and directly perform penetration testing, proactively identifying and defending against hidden threats in the agent ecosystem. In the fields of biotechnology research and genomic analysis, scenarios are being actively explored where AI agents directly query sensitive patient data or high-value compound library databases to automate exploration. If researchers run the config-scan command of mcp-xray on a custom MCP server they have built for data retrieval, it can detect whether API secret keys for accessing remote databases are hardcoded in plain text within local configuration files and verify input/output vulnerabilities that could trigger path traversal attacks at a baseline level. Finally, the results of the penetration testing are output in the standard security report format (SARIF), allowing it to be integrated into the laboratory's internal security review process, enabling the rapid implementation of a secure research automation infrastructure.

When should I use mcp-xray?

mcp-xray is an open-source security scanner and dynamic penetration testing tool released in July 2026 by Traceforce, a security-focused startup. This tool is designed to detect vulnerabilities in the Model Context Protocol (MCP) infrastructure, which acts as a bridge between large language model (LLM)-based AI agents and local data sources. Similar to how traditional web security scanners meticulously analyze web servers to identify vulnerabilities, mcp-xray verifies the configuration integrity of connected MCP servers and performs TLS

📄 Official Docs🐙 GitHub

📝 Update Notes

  1. vv1.0.37/17/2026

    이번 mcp-xray v1.0.3 업데이트는 별도의 상세 변경 내역이 공개되지 않은 마이너 패치 버전이에요. 구체적인 기능 추가보다는 기존 분석 프로세스의 안정성을 높이기 위한 버그 수정이나 최적화가 이루어졌을 가능성이 높습니다. 실험 데이터의 일관된 처리를 위해 도구의 안정성이 중요한 연구원님이라면, 안정성 확보 차원에서 업데이트를 검토해 보시는 것을 추천해요.

🧪 Related Code of Life

No related Code of Life posts yet.