智能代码分析服务器

# Clone repository
git clone <repository-url>
cd empathic

# Build release binary
make release

# Binary will be available at target/release/empathic

# Required
ROOT_DIR=/path/to/your/workspace

# Optional - Core
ADD_PATH=/additional/bin/paths  # Colon-separated additional PATH entries
LOGLEVEL=warn                   # Log level: debug, info, warn, error
LOGFILE=/path/to/logfile.log    # Optional: Write logs to file (stdout + file)

# Optional - LSP Integration (v2.0.0)
LSP_TIMEOUT=60                  # LSP request timeout in seconds
RA_LOG=warn                     # rust-analyzer log level: debug, info, warn, error  
LSP_RESTART_DELAY=2             # Restart delay in seconds for crashed LSP servers

{
  "mcpServers": {
    "empathic": {
      "command": "/path/to/empathic",
      "env": {
        "ROOT_DIR": "/Users/username/projects",
        "LOGLEVEL": "warn"
      }
    }
  }
}

make build    # Debug build for development
make release  # Optimized production build
make test     # Run full test suite
make check    # Run linting and formatting checks
make clean    # Clean build artifacts

src/
├── main.rs           # Entry point and JSON-RPC server
├── lib.rs            # Library exports
├── config.rs         # Configuration management
├── mcp.rs            # MCP protocol implementation
├── fs.rs             # Filesystem utilities
├── lsp/              # 🧠 LSP integration (NEW v2.0.0)
│   ├── mod.rs        # LSP module exports
│   ├── manager.rs    # Process lifecycle management
│   ├── client.rs     # JSON-RPC communication layer
│   ├── project_detector.rs # Rust project detection
│   ├── types.rs      # LSP error wrappers
│   ├── cache.rs      # Response caching with TTL
│   ├── performance.rs # Priority queues and metrics
│   └── resource.rs   # Memory monitoring and restart
└── tools/            # MCP tool implementations
    ├── mod.rs        # Tool registry and common utilities
    ├── env.rs        # Environment variable access
    ├── read_file.rs  # File reading operations
    ├── write_file.rs # File writing operations
    ├── list_files.rs # Directory listing
    ├── delete_file.rs # File deletion
    ├── replace.rs    # Text search and replace
    ├── mkdir.rs      # Directory creation
    ├── symlink.rs    # Symbolic link management
    ├── executor.rs   # Command execution tools
    └── lsp/          # 🧠 LSP tools (NEW v2.0.0)
        ├── mod.rs    # LSP tools exports
        ├── diagnostics.rs # lsp_diagnostics
        ├── hover.rs  # lsp_hover
        ├── completion.rs # lsp_completion
        ├── goto_definition.rs # lsp_goto_definition
        ├── find_references.rs # lsp_find_references
        ├── document_symbols.rs # lsp_document_symbols
        └── workspace_symbols.rs # lsp_workspace_symbols

tests/
├── common/           # Shared test utilities
├── lsp/              # 🧠 LSP integration tests (NEW v2.0.0)
│   ├── manager.rs    # Process management tests
│   ├── client.rs     # JSON-RPC communication tests
│   └── integration.rs # End-to-end LSP tests
├── lsp_tools/        # 🧠 Individual LSP tool tests (NEW v2.0.0)
│   └── *.rs         # Per-tool test files
└── *.rs             # Per-tool test files

# Logs will be written to both stdout and the specified file
export LOGFILE=/var/log/empathic.log

Error: Failed to spawn rust-analyzer: No such file or directory

# Via rustup (recommended)
rustup component add rust-analyzer

# Via package manager
brew install rust-analyzer      # macOS
apt install rust-analyzer       # Ubuntu

Error: LSP request timed out after 60 seconds

Warning: rust-analyzer exceeding memory limit, restarting...

Info: LSP tools available but no rust-analyzer features detected

Slow LSP responses, completion delays

Error: Operation failed outside ROOT_DIR

Error: Permission denied accessing file

Error: Invalid UTF-8 sequence

LOGLEVEL=debug RA_LOG=debug empathic