ravendb-mcp
OfficialThis server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
RavenDB MCP
A local, read-only MCP diagnostics server for RavenDB. Point it at a cluster and your AI agent can inspect cluster, database, index, task, storage, and performance state, plus logs, support packages, and your data, across 21 read-only tools.
Quick start
Launch it with npx (Node.js), dnx (.NET SDK), or a prebuilt binary from Releases, then add it to your client. Set RAVENDB_URLS to your cluster; the examples use http://localhost:8080.
Claude Code
claude mcp add ravendb --scope user --env RAVENDB_URLS=http://localhost:8080 -- npx -y @ravendb/mcpOr install the plugin, which prompts for your cluster URL:
/plugin marketplace add ravendb/ravendb-mcp
/plugin install ravendb-mcp@ravendbClaude Desktop
Download ravendb-mcp-<version>.mcpb from Releases, then install it under Settings > Extensions > Advanced settings > "Install Extension…" (Anthropic's guide). It prompts for your cluster URL, so there is no config to edit and no Node or .NET needed. Config-file setup is in INSTALL.md.
Codex
Add to ~/.codex/config.toml:
[mcp_servers.ravendb]
command = "npx"
args = ["-y", "@ravendb/mcp"]
env = { RAVENDB_URLS = "http://localhost:8080" }Cursor
Click the button (installs with http://localhost:8080; edit for another cluster), or add .cursor/mcp.json:
{
"mcpServers": {
"ravendb": {
"command": "npx",
"args": ["-y", "@ravendb/mcp"],
"env": { "RAVENDB_URLS": "http://localhost:8080" }
}
}
}Then ask the agent “list my RavenDB databases.” Any of these can use dnx RavenDB.Mcp --yes or a binary path in place of npx -y @ravendb/mcp. Secured (HTTPS) clusters, other OSes, and the full configuration reference are in INSTALL.md.
Related MCP server: Linux MCP Server
Features
Developer experience
One-line install with
npx,dnx, or a prebuilt binary.21 tools, one per subject area, each with parameters to select what you need (reduced from 74).
Version-aware RQL docs are served as
rql://resources; a failed query returns the parser error and where to look.
Safety
Read-only: no write, patch, or delete tools, and mutating queries are rejected.
Connection-string secrets (passwords, cloud keys, SAS tokens, AI-provider keys, certificates) are masked in the returned JSON.
Access is scoped to the client certificate's RavenDB permissions.
get_document_dataandrun_queryreturn real cluster data into the agent's context — you choose which cluster to expose. See SECURITY.md.
Context-window friendly
Progressive disclosure: tools return an overview by default and drill into detail on request.
Results are paged:
run_querytakesstartandpageSize(up to 128 rows), and the list tools takepageSize.Log exports and debug packages are written to an artifact file on disk; the tool returns its path and byte size, not the contents.
Query results omit per-document metadata unless you request it.
Runs anywhere
Distributed via npm, NuGet, GitHub Releases, and the MCP Registry.
Self-contained binaries for Windows, macOS, and Linux (x64 and arm64), with no runtime to install.
Run a separate instance per cluster for multi-cluster setups.
Configuration
One server instance targets one cluster. The only required setting is the URL; pass it (and the optional certificate / artifacts settings) as environment variables or a --config JSON file:
Variable | Required | Purpose |
| yes | Cluster node URL(s), comma-separated, the client fails over across them. |
| no | Client |
| no | Where exported files are written (defaults to a temp folder). |
Full configuration reference, including secured clusters and multi-cluster setups, is in INSTALL.md.
Tools
21 read-only tools (snake_case). Most are facet tools: one per subject that takes selectors and returns only the sections you ask for.
Facets:
get_cluster_overview,get_server_config,get_server_resources,get_network_details,get_database_stats,get_database_config,get_index,get_tasks,get_live_workload,inspect_storage,get_document_data,sample_live_feed,wait_for_completion,collect_debug_package,get_ai_agentsSingletons:
list_databases,get_database_record,get_notifications,run_query,list_compare_exchange,export_server_logs
Large or binary output (logs, debug packages) is written to a file and returned as a reference.
Privacy
RavenDB MCP runs locally and sends no data to RavenDB or Anthropic: no telemetry, no analytics. It connects only to the cluster URL(s) you configure (and to npm/NuGet when you install via npx/dnx), returns results to your local agent, masks connection-string secrets, and writes exports only to a local folder you control. Details in PRIVACY.md; RavenDB's company policy is at ravendb.net.
License
MIT. See LICENSE. Building from source is covered in INSTALL.md.
mcp-name: io.github.ravendb/ravendb-mcp
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Hosted MCP server for PostgreSQL diagnostics: slow queries, missing indexes, connection pressure.
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
Read-only MCP access to a documented IT fleet: state, changes, posture. 15 tools.
Self-hosted MCP server: 26 deterministic dev, security, and EVM tools.
Related MCP Servers
- AlicenseCqualityDmaintenanceA local MCP server for the LimaCharlie security platform that provides investigation, administration, and content-review workflows via a broad read-only tool surface with explicit organization scoping and audit logging.100MIT
- AlicenseNot gradedqualityDmaintenanceA read-only MCP server for Linux and macOS system administration, diagnostics, and troubleshooting, supporting remote SSH execution and multi-host management.Apache 2.0
- AlicenseAqualityDmaintenanceRead-only MCP server for diagnosing Windows crashes, stability, and gaming performance by reading event logs, crash dumps, hardware inventory, performance counters, and registry settings.35MIT
- AlicenseAqualityBmaintenanceA secure, local-first MCP server for read-only inspection and troubleshooting of development environments, exposing narrow, typed, auditable capabilities for repository inspection, log summarization, Docker review, and security scanning without granting unrestricted machine access.8MIT