xray / setup / vscode
Setup guide

Set up XRAY in VS Code

communitystdioneeds caution

Progressive code-intelligence server: lets AI assistants map structure, fuzzy-find symbols, and assess change-impact across Python, JS/TS, and Go codebases (powered by ast-grep)


01Configuration
{ "mcpServers": { "xray": { "command": "uvx", "args": [ "--from", "/path/to/xray", "xray-mcp" ] } } }

Add this to .vscode/mcp.json. Generated from the captured install method (uvx); the mcpServers shape is shared across Claude Desktop, Cursor, Windsurf, Cline, and VS Code.


02Steps
  1. Make sure VS Code is installed and up to date.
  2. Open .vscode/mcp.json and add the block above (merge into any existing mcpServers).
  3. Provide any required API keys/credentials as environment variables.
  4. Restart VS Code and confirm XRAY’s tools appear.

03Other runtimes

04Provenance
config_sourcegenerated from captured install method
last_checked2026-08-07 11:02Z
sourcesAwesome MCP Servers (wong2) [p6]

Next step

Want agents that act within guardrails? Apex is the live governed-agent product — paced, capped, and fully-logged actions with approvals before anything runs.

Explore Apex →

See also: server page · is it safe? · alternatives

Set up XRAY MCP in VS Code — MCPExplorer