go-arch-xray

npm distribution of go-arch-xray — a Model Context Protocol (MCP) server for static analysis of Go codebases. Version 0.7.1 includes the project-local .gax/ shadow SQLite index and background sync groundwork while keeping MCP responses on the in-memory analysis read path.

This package contains a small Node launcher. On install, a postinstall script downloads the matching native binary (Windows / macOS / Linux × x64 / arm64) from the corresponding GitHub Release.

Install

npm install -g @hayasaka7/go-arch-xray

Or use it without installing:

npx -y @hayasaka7/go-arch-xray

MCP host configuration

{
  "mcpServers": {
    "go-arch-xray": {
      "command": "npx",
      "args": ["-y", "@hayasaka7/go-arch-xray"]
    }
  }
}

Environment variables

• GO_ARCH_XRAY_BIN — absolute path to a pre-installed binary. When set, postinstall is skipped and the launcher invokes that binary directly. Useful for air-gapped environments or corporate package mirrors.
• GO_ARCH_XRAY_CACHE_CAPACITY — initial in-memory workspace cache capacity for the server process. Repo/user cache_capacity config still takes precedence for analysis requests that load configuration.

Troubleshooting

• Install ran with --ignore-scripts: download blocked. Run npm rebuild @hayasaka7/go-arch-xray once, or set GO_ARCH_XRAY_BIN.
• Behind a firewall: download the matching release asset manually from https://github.com/HAYASAKA7/go-arch-xray/releases, extract it, and set GO_ARCH_XRAY_BIN to the binary path.
• Unsupported platform: build from source — see https://github.com/HAYASAKA7/go-arch-xray#build-from-source.

License

MIT — see LICENSE.