Developer Documentation

Overview

MentisDB is a standalone Rust crate available on crates.io. Add it to your project:

The crate provides the full memory engine, skill registry, storage adapter interface, agent registry, and optional HTTP server (MCP + REST) behind the ssr feature flag.

Full API Reference

The complete, generated API documentation is hosted on docs.rs:

MCP Server

MentisDB ships a built-in MCP (Model Context Protocol) HTTP server. Enable it with the ssr feature. The server exposes all MentisDB operations as MCP tools, making it compatible with any MCP-capable AI tool.

Default endpoint: http://127.0.0.1:9471

The daemon binary (mentisdbd) starts the server automatically. For embedding in your own Axum app, see the docs.rs API reference for server module details.

REST API

The same daemon also serves a REST API alongside MCP. Key endpoints:

Storage Adapters

MentisDB separates the memory model from the storage backend via the StorageAdapter trait:

• BinaryStorageAdapter — Default. Compact binary format with write buffering. Best for production.
• JsonlStorageAdapter — Line-oriented JSON. Human-readable, inspectable with standard tools. Good for debugging.

Implement the StorageAdapter trait to plug in your own backend (S3, SQLite, etc.). See docs.rs for the trait definition.

Contributing

MentisDB is open source under the MIT license.

Run the test suite:

Run benchmarks: