mindforge

本地服务

github.com记忆与知识04 周前更新

关于 mindforge

mindforge-mcp-server 将 MindForge 项目引擎开放给 Claude Code 等 MCP 主机，适合需要查询项目知识图谱、健康状态和审计记录的 Agent。它支持受保护的知识追加写入，并将运行组件打包在单个文件中。

主要功能

01查询知识图谱与相关记忆
02检查项目状态和健康度
03读取防篡改审计日志
04受保护地追加知识条目
05驱动已运行的浏览器守护进程

适用场景

01查找项目决策与设计模式
02检查项目配置及交接状态
03查看特定事件的审计记录

MCP 相关

通过 stdio JSON-RPC 向 MCP 客户端提供 MindForge 查询、状态和审计工具，并提供受保护的知识追加写入。所有操作限定于项目目录；浏览器工具连接本机守护进程。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "sairam0424-mindforge": {
      "command": "npx",
      "args": [
        "-y",
        "mindforge-mcp-server"
      ],
      "env": {
        "CLAUDE_PROJECT_DIR": "<CLAUDE_PROJECT_DIR>"
      }
    }
  }
}

启动命令npx -y mindforge-mcp-server

需要配置的环境变量

CLAUDE_PROJECT_DIRAbsolute path to the project whose .mindforge/ and .planning/ the server reads. Defaults to the current working directory if unset.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmmindforge-mcp-server11.9.8stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

mindforge-mcp-server

通过 stdio，从 Claude Code 或任何 MCP 主机读取 MindForge 引擎中的知识图谱、项目健康状况和审计日志。

一个独立的模型上下文协议（MCP）服务，可将 MindForge 引擎提供给 AI Agent：查询由 SQLite 支持的知识图谱、查找相关记忆、检查项目健康状况，以及读取防篡改审计日志；还提供一个受保护的写入工具，用于持久保存新知识。运行时零依赖（服务及其依赖已打包到单个文件中），因此可在干净安装环境、离线环境以及首次会话中运行。

安装

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

也可以手动将其添加到 MCP 主机配置中（Claude Desktop、Cursor、VS Code）：

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

服务会将每项操作限制在 CLAUDE_PROJECT_DIR（包含 .mindforge/ 和 .planning/ 的项目）内。若未设置，则回退到当前工作目录。如果项目中未初始化 MindForge，每个工具都会以可执行的提示优雅降级，绝不会抛出错误。

工具

工具	访问权限	描述
`mindforge_health`	只读	对当前项目运行 MindForge 健康检查（配置、状态、知识图谱、审计链）。
`mindforge_status`	只读	读取当前项目状态：MindForge 是否已初始化、当前阶段以及交接状态。
`mindforge_memory_query`	只读	按主题、标签和类型搜索知识图谱（架构决策、模式、偏好）。
`mindforge_memory_stats`	只读	报告知识图谱统计信息：条目总数/活跃条目数、类型和标签分布。
`mindforge_memory_find_related`	只读	根据自由文本，通过混合检索（FTS5 + 图遍历）查找相关知识条目。
`mindforge_audit_log`	只读	读取防篡改审计日志（`.planning/AUDIT.jsonl`）中的条目，可按事件筛选。
`mindforge_memory_remember`	写入（受保护）	将新的知识条目（决策、模式或偏好）持久保存到图谱中。
`mindforge_browse`	写入（受保护、开放世界）	驱动 MindForge 浏览器守护进程：状态/导航/点击/输入/截图/断言。要求守护进程已在运行（`/mindforge:browse --start`）；不会启动守护进程，也不会暴露 JS eval 或 Cookie 导入功能。

所有工具都标注了 readOnlyHint / destructiveHint，以便 MCP 主机执行恰当的信任边界；只有 mindforge_memory_remember 会写入，且仅以追加方式写入。

传输与安全

传输： stdio JSON-RPC（单个内嵌客户端）。
范围： 仅在 CLAUDE_PROJECT_DIR 内进行读取/追加，另有一个仅限回环地址的代理连接到 MindForge 浏览器守护进程（mindforge_browse）——不执行 shell 命令。MCP 服务进程本身只会与 127.0.0.1 通信；守护进程是一个独立且预先存在的进程，本服务绝不会启动它，由该守护进程在页面导航时执行实际的浏览器网络外连。
独立运行： SDK 和 Zod 已打包到 dist/index.js 中；运行时无需 node_modules。