RuVector MCP Server

Gives a coding agent local semantic memory, code analysis and routing tools from the RuVector vector database.

Official · rUv Rust Local · stdio Knowledge and memoryDeveloper tools

105 popularity score ★ 4.7k ↓ 250k/wk

Connect your client

Local (npm)

Add in one click

Opens the app, which asks before it adds the server.

Or add it by command or config

Claude CodeTerminal
claude mcp add ruvector -- npx -y ruvector mcp start
Claude Desktopclaude_desktop_config.json
{
  "mcpServers": {
    "ruvector": {
      "command": "npx",
      "args": [
        "-y",
        "ruvector",
        "mcp",
        "start"
      ]
    }
  }
}
Cursor~/.cursor/mcp.json
{
  "mcpServers": {
    "ruvector": {
      "command": "npx",
      "args": [
        "-y",
        "ruvector",
        "mcp",
        "start"
      ]
    }
  }
}
VS Code.vscode/mcp.json
{
  "servers": {
    "ruvector": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ruvector",
        "mcp",
        "start"
      ]
    }
  }
}
Codex~/.codex/config.toml
[mcp_servers.ruvector]
command = "npx"
args = ["-y", "ruvector", "mcp", "start"]
Gemini CLITerminal
gemini mcp add --scope user ruvector npx -- -y ruvector mcp start

Settings 3

RUVECTOR_MCP_PROFILE Optional: Set to readonly for a non-mutating subset of tools.
RUVECTOR_MCP_ALLOW Optional: Comma-separated tools to expose; everything else is denied.
RUVECTOR_MCP_DENY Optional: Comma-separated tools to block (deny wins over allow).

What it does

RuVector is a Rust-based, self-learning vector database for Node.js with semantic search, hybrid retrieval, graph relationships and feedback learning, and its npm package includes an MCP server (npx ruvector mcp start). Its tools give an agent semantic context retrieval, code analysis (structure, complexity, change classification, code boundaries, test-aware routing, a security scan), agent routing that learns from recorded outcomes, package and file decompilation with a witness record, and optional shared-brain, edge-cluster and identity tools.

The README describes about 97 tools and says to run npx ruvector mcp tools for the current, authoritative list; the main ones are shown here. Exposed tools can be narrowed with RUVECTOR_MCP_ALLOW and RUVECTOR_MCP_DENY or a read-only profile (RUVECTOR_MCP_PROFILE=readonly).

The default retrieval path runs locally with no database server or API key; the first semantic command downloads and caches a small embedding model. For automated agents the README recommends installing a pinned version locally (npm install --save-exact ruvector) rather than fetching @latest on each run.

What it needs

RuntimeNode.js

Tools 25

hooks_route
Agent routing with signals.
hooks_route_enhanced
Agent routing with signals (enhanced).
hooks_ast_analyze
Code structure analysis.
hooks_ast_complexity
Code structure analysis: complexity.
hooks_diff_analyze
Change classification: analyze a diff.
hooks_diff_classify
Change classification.
hooks_coverage_route
Test-aware routing.
hooks_coverage_suggest
Test-aware routing: suggestions.
hooks_graph_mincut
Code boundaries (graph min-cut).
hooks_graph_cluster
Code boundaries (clustering).
hooks_security_scan
Vulnerability detection.
hooks_rag_context
Semantic context retrieval.
hooks_attention_info
Neural capabilities: attention.
hooks_gnn_info
Neural capabilities: graph neural networks.
brain_search
Shared brain knowledge: search.
brain_share
Shared brain knowledge: share.
brain_status
Shared brain knowledge: status.
decompile_package
Package decompilation with a witness record.
decompile_file
File decompilation with a witness record.
decompile_url
Decompilation from a URL with a witness record.
edge_status
Edge cluster coordination: status.
edge_join
Edge cluster coordination: join.
edge_balance
Edge cluster coordination: balance.
identity_generate
Agent identity: generate.
identity_show
Agent identity: show.

Similar servers