
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 分
