rust-analyzer-server

A standalone HTTP server for rust-analyzer that keeps the language server warm across requests, with installable Claude Code skills for seamless integration.

How It Works

rust-analyzer-server (persistent HTTP server, rust-analyzer always warm)
  ^  REST API (localhost:15423)
  |
Claude Code skills (.claude/commands/ra-*.md)
  -> curl calls to the HTTP server

The server starts rust-analyzer once and keeps it running. All subsequent requests are fast because the project is already indexed.

Prerequisites

1. rust-analyzer in your PATH:

   rustup component add rust-analyzer
   

2. Rust 1.70+ with Cargo

Installation

From Source

git clone https://github.com/DSmyungjin/rust-analyzer-server.git
cd rust-analyzer-server
cargo build --release

The binary will be at target/release/rust-analyzer-server.

Usage

Start the Server

# Start with default settings (port 15423, current directory as workspace)
rust-analyzer-server

# Specify workspace and port
rust-analyzer-server --workspace /path/to/project --port 4000

# Custom bind address
rust-analyzer-server --bind 0.0.0.0 --port 15423

Environment variable RUST_ANALYZER_PORT can also set the port.

Install Claude Code Skills

Copy skill templates into any project:

rust-analyzer-server install /path/to/your/project

This creates .claude/commands/ra-*.md files that provide slash commands like /ra-hover, /ra-definition, /ra-references, etc.

API Endpoints

All responses use a JSON envelope:

{"ok": true, "result": {...}}
{"ok": false, "error": "..."}

Example API Calls

# Health check
curl http://localhost:15423/api/v1/health

# Get hover info
curl -X POST http://localhost:15423/api/v1/rust_analyzer_hover \
  -H 'Content-Type: application/json' \
  -d '{"file_path":"src/main.rs","line":5,"character":10}'

# Find definition
curl -X POST http://localhost:15423/api/v1/rust_analyzer_definition \
  -H 'Content-Type: application/json' \
  -d '{"file_path":"src/main.rs","line":10,"character":15}'

# Workspace symbol search
curl -X POST http://localhost:15423/api/v1/rust_analyzer_workspace_symbol \
  -H 'Content-Type: application/json' \
  -d '{"query":"MyStruct"}'

Available Tools

Installed Skills

After running rust-analyzer-server install, these slash commands become available in Claude Code:

Development

cargo build          # Build
cargo test           # Run all 35 tests
cargo run            # Run in dev mode
RUST_LOG=debug cargo run  # Verbose logging

License

MIT