Mindforge

io.github.sairam0424由 GitHub 帳號 sairam0424 發布v11.9.8更新於 Oct 24, 2026

Read the MindForge engine over MCP: knowledge graph, project health, and audit log.

已驗證STDIO僅桌面瀏覽器自動化知識與記憶

概覽

AI 產生的概覽

一個本機 stdio MCP 伺服器，讓助理讀取 MindForge 專案的知識圖譜、健康狀態、專案狀態與稽核日誌，並可附加新的知識條目。

可以做什麼
檢查目前專案的健康狀態，讀取是否已初始化、目前階段與交接狀態。依主題、標籤和類型搜尋以 SQLite 為後端的知識圖譜，並用混合檢索從自由文字中找出相關條目。回報知識圖譜統計資訊，例如條目總數、類型和標籤分布。讀取防竄改稽核日誌中的條目，可依事件篩選。將新的知識條目（決策、模式或偏好）附加到圖譜。驅動已在執行的 MindForge 瀏覽器守護程序，進行狀態查詢、導覽、點擊、輸入、截圖和斷言。
適用情境
適用於已用 MindForge 設定的專案：希望助理查閱已記錄的決策、模式和偏好、檢查專案健康狀態，或不必離開工作階段就能查看稽核紀錄。
執行需求
透過 stdio 在本機執行，通常以 npx 從 npm 套件 mindforge-mcp-server 啟動，需要 Node.js。專案需包含 MindForge 的 .mindforge/ 和 .planning/ 目錄。需將 CLAUDE_PROJECT_DIR 設為專案路徑，未設定時預設為目前工作目錄。瀏覽器工具需要 MindForge 瀏覽器守護程序已在執行。
安裝前請注意
memory-remember 工具會將新條目寫入專案知識圖譜；browse 工具可在瀏覽器中導覽、點擊和輸入，因而會將資料傳送到第三方網站。伺服器將操作限定在 CLAUDE_PROJECT_DIR 內，且本身只連線本機回環位址，但實際網路存取由獨立的瀏覽器守護程序完成。MindForge 未初始化時，工具會回傳提示訊息而不會拋出錯誤。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mindforge，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

mindforge-mcp-server

Read the MindForge engine — knowledge graph, project health, and audit log — from Claude Code or any MCP host, over stdio.

[npm version] [License: MIT]

A self-contained Model Context Protocol (MCP) server that exposes the MindForge engine to AI agents: query the SQLite-backed knowledge graph, find related memory, check project health, and read the tamper-evident audit log — plus one guarded write to persist new knowledge. Zero runtime dependencies (the server and its deps are bundled into a single file), so it runs on a clean install, offline, and on first session.

Install

bash
claude mcp add mindforge -- npx -y mindforge-mcp-server

Or add it manually to your MCP host config (Claude Desktop, Cursor, VS Code):

json
{  "mcpServers": {    "mindforge": {      "command": "npx",      "args": ["-y", "mindforge-mcp-server"],      "env": { "CLAUDE_PROJECT_DIR": "${workspaceFolder}" }    }  }}

The server scopes every operation to CLAUDE_PROJECT_DIR (the project containing .mindforge/ and .planning/). If unset, it falls back to the current working directory. Every tool degrades gracefully with an actionable message when MindForge is not initialized in the project — it never throws.

Tools

ToolAccessDescription
mindforge_healthread-onlyRun a MindForge health check on the current project (config, state, knowledge graph, audit chain).
mindforge_statusread-onlyRead current project status: whether MindForge is initialized, active phase, and handoff state.
mindforge_memory_queryread-onlySearch the knowledge graph (architectural decisions, patterns, preferences) by topic, tags, and type.
mindforge_memory_statsread-onlyReport knowledge-graph statistics: total/active entries, types, and tag distribution.
mindforge_memory_find_relatedread-onlyGiven free text, find related knowledge entries via hybrid (FTS5 + graph-traversal) retrieval.
mindforge_audit_logread-onlyRead entries from the tamper-evident audit log (.planning/AUDIT.jsonl), optionally filtered by event.
mindforge_memory_rememberwrite (guarded)Persist a new knowledge entry (decision, pattern, or preference) into the graph.
mindforge_browsewrite (guarded, open-world)Drive the MindForge browser daemon: status/navigate/click/type/screenshot/assert. Requires the daemon to already be running (/mindforge:browse --start); never spawns it, and never exposes JS eval or cookie import.

All tools are annotated with readOnlyHint / destructiveHint so MCP hosts can enforce the right trust boundary; only mindforge_memory_remember writes, and it is append-only.

Transport & security

  • Transport: stdio JSON-RPC (single embedded client).
  • Scope: read/append only within CLAUDE_PROJECT_DIR, plus a loopback-only proxy to the MindForge browser daemon (mindforge_browse) — no shell execution. The MCP server process itself only ever talks to 127.0.0.1; the daemon (a separate, pre-existing process this server never spawns) performs the actual browser network egress when a page navigates.
  • Self-contained: the SDK and Zod are bundled into dist/index.js; no node_modules are needed at runtime.

Part of MindForge

This server ships standalone (npm + MCP registries) and bundled inside the MindForge Claude Code plugin. For the full framework — slash commands, subagents, governance, and cost-aware model routing — see the main repository.

License

MIT © MindForge Team

來源：mcp-server/README.md，提交 ce0a58d

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

2
  1. v11.9.8最新Sep 21, 2026
  2. v11.5.1Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分