
Ravendb Mcp
io.github.ravendb由 GitHub 账号 ravendb 发布v1.0.4更新于 Oct 24, 2026
Read-only MCP diagnostics server for RavenDB.
概览
面向 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 指定导出文件位置。一个实例对应一个集群。
安装
在 SourceWeft 中
- 打开 控制台中的 Ravendb Mcp,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
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
Or install the plugin, which prompts for your cluster URL:
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:
Cursor
Click the button (installs with http://localhost:8080; edit for another cluster), or add .cursor/mcp.json:
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_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:
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版本历史
1- v1.0.4最新Sep 16, 2026
评分
已满足适用检查项的 50%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分
