lunaris-mcp

Lunaris MCP server — no Rust toolchain required.

Each wheel ships a prebuilt lunaris-mcp binary for your platform. uvx resolves the correct wheel automatically; the binary is exec'd via python -m lunaris_mcp.

Quick Start

via uvx (recommended)

uvx lunaris-mcp --help

via pip

pip install lunaris-mcp
lunaris-mcp --help

Configure as an MCP server

Claude Code (~/.claude.json)

{
  "mcpServers": {
    "lunaris": {
      "command": "uvx",
      "args": ["lunaris-mcp"]
    }
  }
}

Or using npx:

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

Codex (~/.codex/config.toml)

[mcp_servers.lunaris]
command = "uvx"
args    = ["lunaris-mcp"]

Supported Platforms

Requirements

• Python 3.11+
• No Rust toolchain required
• uv (recommended) or pip

If the binary is missing

If the binary is absent from the wheel (local dev, custom build), the lunaris-mcp entry point will print a clear error and suggest a source build:

cargo install --git https://github.com/pilotspace/lunaris lunaris-mcp

lunaris-mcp is not on crates.io — it links lunaris-memory-service, which carries a vendor/ path dependency and is therefore publish = false, and crates.io rejects a crate with unpublished dependencies. Plain cargo install lunaris-mcp will fail.

Air-gap / offline

For offline environments, either extract the prebuilt lunaris-mcp-<target>.tar.gz from a GitHub release (attached from 0.6.1 onward), or build from a checkout (needs Rust 1.94, cmake, and a C++ compiler for llama.cpp):

git clone --recurse-submodules https://github.com/pilotspace/lunaris
cd lunaris && cargo build --release -p lunaris-mcp
# binary at target/release/lunaris-mcp

Then use the lunaris-mcp binary directly.

Full integration guide

See docs/integration/claude-code.md and docs/integration/codex.md for complete configuration examples, environment variables, and troubleshooting.