This package is a thin wrapper: it runs oxcode mcp from the oxcode binary, which you install once and which then self-updates. The package exists so the server can be listed in the official MCP Registry; it does not bundle or download the binary.

Prerequisite: install the `oxcode` binary

# Prebuilt (recommended)
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/oxgraph/oxcode/releases/latest/download/oxcode-cli-installer.sh | sh
# or
cargo binstall oxcode-cli   # prebuilt, no compile
cargo install  oxcode-cli   # from source

(The crate is oxcode-cli; the command is oxcode.)

Use as an MCP server

{
  "mcpServers": {
    "oxcode": { "command": "npx", "args": ["-y", "@snowmead/oxcode-mcp"] }
  }
}

This is equivalent to running oxcode mcp directly — if you already have the binary, pointing your client at command: "oxcode", args: ["mcp"] is simpler and avoids the Node hop.

Call the oxcode_watch tool once: it builds the index and keeps it current as files change. Across many oxcode mcp processes on one folder, a file lock elects a single writer (the one watcher/re-indexer) while the rest serve reads, and a standby takes over if the writer exits. See the oxcode repo for the full CLI and tool list.