Ravendb Mcp

io.github.ravendb由 GitHub 账号 ravendb 发布v1.0.4更新于 Oct 24, 2026

Read-only MCP diagnostics server for RavenDB.

已验证STDIO仅桌面数据库安全与监控

概览

AI 生成的概览

面向 RavenDB 的本地只读 MCP 诊断服务器,让助手查看集群、数据库、索引、任务、存储与性能状态。

可以做什么
  • 查看集群与服务器状态:概览、配置、资源、网络详情、通知与比较交换
  • 查看数据库:列出数据库、数据库记录、统计信息与配置
  • 检查索引、任务、实时工作负载与存储,并可采样实时数据流
  • 读取数据:获取文档并执行分页 RQL 查询,附带按版本提供的 RQL 文档资源
  • 收集诊断信息:将服务器日志与调试包导出到本地文件,并等待操作完成
适用场景
适合希望让 AI 助手协助排查 RavenDB 集群或数据库问题(索引、任务、存储、性能或查询结果)而不授予写权限的场景。面向已运行 RavenDB、想通过助手做只读检查的开发者和运维人员。
运行要求
以本地进程运行,可通过 npx(Node.js)、dnx(.NET SDK)或预编译二进制启动,也提供 Claude Desktop 扩展包。需要设置 RAVENDB_URLS 指定集群节点地址。安全(HTTPS)集群需通过 RAVENDB_CERTIFICATE_PATH 和 RAVENDB_CERTIFICATE_PASSWORD 提供客户端 .pfx 证书。可选 RAVENDB_ARTIFACTS_PATH 指定导出文件位置。一个实例对应一个集群。
安装前请注意
文档与查询工具会把真实集群数据带入助手上下文,请谨慎选择要暴露的集群。访问权限受客户端证书的 RavenDB 权限限制。证书密码通过 RAVENDB_CERTIFICATE_PASSWORD 提供。日志与调试包会导出到你配置的本地目录。没有写入、修改或删除工具,变更类查询会被拒绝。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Ravendb Mcp,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

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

powershell
claude mcp add ravendb --scope user --env RAVENDB_URLS=http://localhost:8080 -- npx -y @ravendb/mcp

Or install the plugin, which prompts for your cluster URL:

/plugin marketplace add ravendb/ravendb-mcp/plugin install ravendb-mcp@ravendb

Claude 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:

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:

[Add to Cursor]

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.

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_data and run_query return 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_query takes start and pageSize (up to 128 rows), and the list tools take pageSize.
  • 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:

VariableRequiredPurpose
RAVENDB_URLSyesCluster node URL(s), comma-separated, the client fails over across them.
RAVENDB_CERTIFICATE_PATH / _PASSWORDnoClient .pfx for secured (HTTPS) clusters. Omit for unsecured.
RAVENDB_ARTIFACTS_PATHnoWhere 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_agents
  • Singletons: 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

来源:README.md,提交 648417b

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v1.0.4最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分