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 分