Rusty
CaliLuke1 étoiles
A minimal Rust vector-memory server that works with Qdrant and Ollama.
- Transport
- stdio
- État
- Local
Alimenter votre agent
Installation de l'éditeur. Ce n'est pas un endpoint PlugMCP.
Host a copy with our keys and logs.
Pas encore de version packagée dans le registre. Suivez le README du dépôt.
URL distante ou commande sur votre machine ? Ce qui distingue les deux installations
Exécuter sur PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LancerRusty Memory MCP is a no‑fuss memory server for coding agents. It chunks text, generates embeddings, and stores vectors in Qdrant. You can run it as:
If you want to hack on the codebase or learn how it works internally, jump to Developer Docs below.
Install the binaries
cargo install rustymcp
This installs:
rusty_mem_mcp (MCP server)rustymcp (HTTP server)metrics-post (helper used by scripts)Start Qdrant (vector database)
docker run --pull=always -p 6333:6333 qdrant/qdrant:latest
Configure environment
Copy .env.example to .env and edit values, or provide the same variables via your MCP client config:
Required variables:
QDRANT_URL (e.g. http://127.0.0.1:6333)QDRANT_COLLECTION_NAME (e.g. rusty-mem)EMBEDDING_PROVIDER (ollama enables the local client; other values use the deterministic fallback for now)EMBEDDING_MODEL (free‑form, e.g. nomic-embed-text)EMBEDDING_DIMENSION (must match your model, e.g. 768)OLLAMA_URL (optional, defaults to http://127.0.0.1:11434 when EMBEDDING_PROVIDER=ollama)Launch the MCP server
rusty_mem_mcp
Add to your agent
Codex CLI (~/.codex/config.toml):
[mcp_servers.rusty_mem]
command = "rusty_mem_mcp" # or use the full path to the binary
args = []
transport = "stdio"
[mcp_servers.rusty_mem.env]
QDRANT_URL = "http://127.0.0.1:6333"
QDRANT_COLLECTION_NAME = "rusty-mem"
EMBEDDING_PROVIDER = "ollama"
EMBEDDING_MODEL = "nomic-embed-text"
EMBEDDING_DIMENSION = "768"
OLLAMA_URL = "http://127.0.0.1:11434" # omit to use the default
JSON clients (Kilo, Cline, Roo Code):
{
"mcpServers": {
"rusty": {
"command": "rusty_mem_mcp",
"args": [],
"transport": "stdio",
"env": {
"QDRANT_URL": "http://127.0.0.1:6333",
"QDRANT_COLLECTION_NAME": "rusty-mem",
"EMBEDDING_PROVIDER": "ollama",
"EMBEDDING_MODEL": "nomic-embed-text",
"EMBEDDING_DIMENSION": "768",
"OLLAMA_URL": "http://127.0.0.1:11434"
}
}
}
}
Try it
From your agent, use:
push → ingest text with optional metadata (project_id, memory_type, tags, source_uri)search → retrieve memories semantically with filters for project, memory type, tags, time range, and score thresholdsummarize → condense episodic memories into semantic summaries with provenance and idempotent summary_keysget-collections → list Qdrant collectionsnew-collection → create or resize a collectionmetrics → view counters (documentsIndexed, chunksIndexed, lastChunkSize)listResources → discover read-only resources; use readResource on:
mcp://memory-typesmcp://projectsmcp://healthmcp://settings (search defaults)mcp://usage (usage policy and recommended flows)mcp://{project_id}/tagsIf you prefer HTTP, set the same environment and run:
rustymcp
By default the server binds the first free port in 4100–4199 (or SERVER_PORT if set). Example:
curl -sS -X POST http://127.0.0.1:4100/index \
-H 'Content-Type: application/json' \
-d '{"text":"hello from http"}'
Returns { "chunks_indexed": <number>, "chunk_size": <number>, "inserted": <number>, "updated": <number>, "skipped_duplicates": <number> } on success.
Having trouble? See docs/Troubleshooting.md.
If you want to extend Rusty Memory or understand the architecture:
docs/Configuration.mddocs/Design.mddocs/Editors.mddocs/Development.mdLicensed under the PolyForm Noncommercial License 1.0.0. Free for non‑commercial use.
Issues and PRs are welcome. If anything in the Quick Start is unclear, please open an issue so we can make onboarding even smoother.
A minimal Rust vector-memory server that works with Qdrant and Ollama.
Outils
Pas encore de liste d'outils. Les serveurs distants en obtiennent une après le premier contrôle d'état.
FAQ
Copiez sur cette page la configuration stdio pour Cursor, Claude Desktop, Claude Code ou VS Code. Elle utilise l'installation de l'éditeur, pas un proxy PlugMCP.
Aucune variable d'environnement requise n'est indiquée sur cette fiche.
Rusty s'exécute en local via stdio.
Dernière vérification : 2026-10-28. A minimal Rust vector-memory server that works with Qdrant and Ollama.