Second Brain Health Check MCP Server安装配置 GitHub与使用方法

选型结论

Second Brain Health Check 属于开发工具类 MCP Server，公开资料标注 9 个工具，通过stdio 本地进程接入，适配 Claude Desktop、Claude，有可以直接复制的安装命令；接入前先确认权限范围。

分类

开发工具

传输方式

stdio

认证方式

无需认证

部署方式

公开资料未说明

安装与配置

安装命令

npx @iwo-szapar/second-brain-health-check setup

客户端配置示例

{
  "mcpServers": {
    "second-brain-health-check": {
      "command": "npx",
      "args": [
        "@iwo-szapar/second-brain-health-check",
        "setup"
      ]
    }
  }
}

按公开安装命令拼出来的示例，字段名和参数以仓库 README 为准；带 YOUR_API_KEY 这类占位符的位置记得换成自己的值。

上手步骤

1
准备运行环境
stdio 服务在本地起进程，需要先装好 Node.js，再按安装命令拉取依赖。
2
安装服务
复制下面的安装命令执行；命令里带占位符的位置换成自己的密钥或路径。
3
写入客户端配置
在客户端的 MCP 配置里填启动命令和参数，保存后完全退出客户端再打开，让新配置生效。
4
验证是否可用
连接成功后客户端会列出 9 个工具，随便调一个只读工具确认能返回结果。

接入前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

详细介绍

MemoryOS

Your Claude Code setup has 45 things that could be better. This finds them in 2 seconds.

Open-source context engineering scanner for Claude Code

在45个检查层和3个维度上对您的克劳德代码设置进行评分。返回具有上下文工程模式映射的自适应报告、具有时间估计的优先级修复和HTML仪表板。免费工具在本地运行，无需网络调用。付费工具解锁了进度跟踪、上下文分析、对话导入和AI驱动的升级。

______________________________________________________________________

安装

一个命令设置

npx @iwo-szapar/second-brain-health-check setup

互动式入职培训（约2分钟）：

询问您的API密钥（或跳过免费层）
用Claude代码配置MCP服务器
询问你的角色、经验和目标
运行第一次健康检查并打开仪表板

手动MCP设置

claude mcp add second-brain-health-check -- npx @iwo-szapar/second-brain-health-check

然后问克劳德：“对我的项目进行健康检查。”

______________________________________________________________________

工具

免费工具

不需要API密钥。在本地运行，无网络呼叫。

`check_health`

完整的45层扫描，涵盖设置质量、使用活动和AI流畅性。根据你大脑的成熟度调整报告。

> Run a health check

> Check my setup health in quick mode

> Run health check in Spanish

参数：

参数	默认值	选项
`path`	当前目录	项目根目录的路径
`mode`	`full`	`full` （45层）， `quick` （仅约100ms检测）， `manifest` （完整+YAML输出）
`language`	`en`	`en`, `es`, `de`, `fr`, `pl`, `pt`, `ja`, `ko`, `zh`, `it`, `nl`, `ru`, `tr`, `ar`
`workspace_type`	--	`solo`, `team`, `enterprise`
`use_case`	--	`development`, `content`, `operations`, `research`, `mixed`

`get_fix_suggestions`

针对你最薄弱的领域制定优先行动计划。每个修复都包括时间估计和点值。

> What should I fix first in my setup?

> Give me fix suggestions focused on setup quality

参数：

参数	默认值	选项
`path`	当前目录	项目根目录的路径
`focus`	`auto`	`auto` （挑选最弱的）， `setup`, `usage`, `fluency`
`language`	`en`	与check_health相同

`generate_dashboard`

具有分数可视化、CE雷达图和引导修复的独立HTML仪表板。在浏览器中打开。

> Generate a health check dashboard

> Generate dashboard and save to ~/reports/brain.html

参数：

参数	默认值	选项
`path`	当前目录	项目根目录的路径
`output`	`health-check-report.html`	输出文件路径

`generate_pdf`

通过无头Chrome浏览器生成PDF报告。需要安装Chrome或Chromium。

> Generate a PDF health check report

参数：

参数	默认值	选项
`project_path`	（必填）	项目的绝对路径

______________________________________________________________________

付费工具

需要API密钥。集 SBK_TOKEN 在您的环境中或跑步 setup 配置。

`weekly_pulse`

随着时间的推移跟踪进度。显示分数增量、CE模式趋势、条纹检测和有针对性的建议。

> Show my weekly pulse

> Show my progress over the last 30 days

参数：

参数	默认值	选项
`period`	`since_last`	`since_last`, `7d`, `30d`
`path`	当前目录	项目根目录的路径

`context_pressure`

分析固定开销（CLAUDE.md、MEMORY.md、知识文件、MCP定义、技能、钩子和设置）消耗了20万令牌上下文窗口的多少。

> Check my context pressure

> How much of my context window am I using?

参数：

参数	默认值	选项
`path`	当前目录	项目根目录的路径

`audit_config`

审核您的配置，查看是否存在死引用、冲突、安全问题、未使用项和性能问题。

> Audit my config

> Run a security audit on my setup

参数：

参数	默认值	选项
`path`	当前目录	项目根目录的路径
`check_categories`	全部5	`references`, `conflicts`, `security`, `unused`, `performance`

每个类别检查的内容：

参考文献 --CLAUDE.md中的死文件路径，缺少挂钩脚本
冲突 --重复的CLAUDE.md文件、重叠的MCP服务器、不匹配的挂钩
安全 -- .env 在 .gitignore，配置文件中的API密钥模式，通配符权限
未使用的 --会话日志中零调用的技能
演出 --CLAUDE.md过大（>300行），MEMORY.md（>180行），MCP工具过多（>30）

`import_context`

从ChatGPT导入对话历史记录，或将Claude导出到有组织的内存文件中。先扫描以预览，然后导入以创建文件。

> Scan my ChatGPT export at ~/Downloads/conversations.json

> Import my ChatGPT conversations, only coding-related ones from 2025

参数：

参数	默认值	选项
`source_type`	（必填）	`chatgpt_export` （对话.json）或 `claude_export` （目录）
`source_path`	（必填）	导出文件或目录的路径
`mode`	`scan`	`scan` （仅预览）或 `import` （写入文件）
`output_dir`	`memory/imported/`	在哪里写入导入的文件
`max_conversations`	无限制	限制已处理的对话
`min_messages`	`3`	跳过简短对话
`date_after`	--	ISO日期过滤器（例如。 `2024-01-01`)
`date_before`	--	ISO日期过滤器
`categories`	全部	`coding`, `writing`, `research`, `planning`, `data`, `creative`, `operations`
`merge_existing`	`false`	如果为真，请写信给 `memory/semantic/` 相反
`language`	`en`	输出语言

`upgrade_brain`

识别设置中丢失和过时的文件，并生成个性化升级。在本地运行运行运行状况检查和清点，然后调用Factory API进行模板匹配和个性化设置。需要 SBK_TOKEN env-var（MemoryOS用户权益）。

> Upgrade my brain

> Show me what files I'm missing (dry run)

> Upgrade brain, high impact only

参数：

参数	默认值	选项
`path`	当前目录	项目根目录的路径
`high_only`	`false`	仅显示高影响文件
`category`	全部	`agent`, `skill`, `memory`, `config`, `docs`
`dry_run`	`false`	预览差异而不应用

______________________________________________________________________

命令行界面

# First-time setup (interactive)
npx @iwo-szapar/second-brain-health-check setup

# Run health check (prints report + opens dashboard)
npx @iwo-szapar/second-brain-health-check

# Scan a specific directory
npx @iwo-szapar/second-brain-health-check /path/to/project

# Text report only (no browser)
npx @iwo-szapar/second-brain-health-check --no-open

# Generate PDF report
npx @iwo-szapar/second-brain-health-check --pdf

______________________________________________________________________

它衡量什么

三维。45个检查层。~459个原始点，每个标准化为/100。

SETUP QUALITY      32 layers    ~284 pts
A (85%+) | B (70%+) | C (50%+) | D (30%+) | F ( 快速工程优化了单个LLM呼叫。
> 上下文工程优化了围绕这些调用的持久系统--
> 塑造每个会话的文件、钩子、记忆和技能。

您的CLAUDE.md， `.claude/` 目录、技能、钩子、内存文件、MCP服务器和规划工件形成了一个持久的上下文层。MemoryOS对该层进行评分，而不是对提示进行评分。

______________________________________________________________________

## 故障排除

### 从以下位置迁移 `@iwo-szapar/memoryos`

旧包裹 `@iwo-szapar/memoryos` 已弃用。如果你看到 `Memoryos [tool_name]` （大写M）在您的工具输出中，您使用的是旧软件包。

**克劳德代码CLI：**

claude mcp remove memoryos claude mcp remove second-brain-health-check npm cache clean --force claude mcp add second-brain-health-check -- npx @iwo-szapar/second-brain-health-check@latest


**VS代码（Claude扩展名）：**

VS代码扩展名为 `.mcp.json` 在项目根目录中（不是 `.claude.json`).创建或编辑 `.mcp.json`:

{ "mcpServers": { "second-brain-health-check": { "type": "stdio", "command": "npx", "args": ["@iwo-szapar/second-brain-health-check@latest"], "env": { "SBK_TOKEN": "your_sbk_token_here" } } } }


**克劳德桌面/协作：**

Claude Desktop将MCP配置存储在单独的文件中（不是 `.claude.json` 或 `.mcp.json`):

- **macOS：** `~/Library/Application Support/Claude/claude_desktop_config.json`
- **窗户：** `%APPDATA%\Claude\claude_desktop_config.json`
- **Linux：** `~/.config/Claude/claude_desktop_config.json`

打开那个文件，找到旧的 `"memoryos"` 进入下 `"mcpServers"`，并替换为：

"second-brain-health-check": { "command": "npx", "args": ["@iwo-szapar/second-brain-health-check@latest"], "env": { "SBK_TOKEN": "your_sbk_token_here" } }


然后重新启动应用程序。

**哪个配置文件做什么：**

|客户端|配置文件|作用域|
|:-------|:-----------|:------|
|克劳德代码CLI| `.claude.json` |每个项目（在项目根中）或全局(`~/.claude.json`) |
|VS代码扩展| `.mcp.json` |每个项目（以项目根为单位）|
|克劳德桌面/协作| `claude_desktop_config.json` |全局（见上面的路径）|

### Windows：路径错误

如果你看到 `Path "c:\Users\..." is outside the home directory`，驱动器号大小写不匹配。已在v0.17.2+版本中修复。更新为：

npm cache clean --force


然后重新运行该工具。服务器在下次调用时获取最新版本。

### 固定 npx 缓存

如果更新后修复未生效，则npx可能正在提供缓存的旧版本。标志：错误消息参考 `UPGRADE_BRAIN_API_KEY` （在v0.17.2中删除），或工具输出缺少 `[MemoryOS vX.Y.Z]` 版本前缀。

npm cache clean --force npx clear-npx-cache


### 如何检查您的版本

每个工具响应都始于 `[MemoryOS v0.17.5]` （或您安装的版本）。如果您没有看到此前缀，则表示您使用的是v0.17.4或更旧版本。

______________________________________________________________________

[记忆](https://www.iwoszapar.com/memory-os) 通过 [伊沃 沙帕尔](https://www.iwoszapar.com).MIT许可证。

工具与能力

工具数量

9

资源数量

0

提示词数量

0

能力标签

代码分析JavaScript本地部署AI开发工具上下文工程健康检查Claude扩展

支持客户端

Claude DesktopClaude

数量来自来源目录的标注，具体工具清单以官方文档为准。

典型使用场景

让助手直接读代码

把仓库、提交记录和 issue 交给模型检索，补全和重构时不用来回复制文件。

在对话里跑命令

触发构建、测试和脚本，执行结果直接回到上下文，省去切终端。

接进开发流程

把 PR、CI 状态和代码审查接进助手，减少在几个工具之间跳。

选择建议

值得选的地方

只提供 9 个工具，职责集中，接入后不容易误操作。
有现成的安装命令，不用自己找入口，照着跑就能起服务。
已经适配 Claude Desktop、Claude，换客户端不用重新研究配置。

先想清楚的地方

stdio 方式要求本地装好 Node.js，换机器要重新装一遍。
公开摘要偏短，具体能力和限制要回到仓库确认。
第三方目录整理，版本更新和行为细节以官方仓库为准。

更适合

需要在开发工具场景里让模型直接调用外部能力的人。
已经在用 Claude Desktop 的用户，接入路径最短。
想先快速试一下、能接受在本地跑服务的人。

不太适合

完全不想在本地装环境的人。
需要厂商级 SLA 和技术支持的生产环境。

MCP Server	工具数	传输方式	安装命令	收录来源	最后核验
Second Brain Health Check MCP World · 本页	9	stdio	有	1 个	2026-05-17
Git 838e2ec1 MCP World	12	stdio	有	2 个	2026-05-17
Markitdown MCP 2c653a5f MCP World	1	stdio	有	1 个	2026-05-17
Context7 MCP C671e75a MCP World	0	stdio	有	1 个	2026-05-17
Context7 831acf40 MCP World	0	stdio	有	1 个	2026-05-17

常见问题

5 条

Second Brain Health Check 怎么安装？

公开资料给出的安装命令是 npx @iwo-szapar/second-brain-health-check setup，运行环境为 Node.js。装完后按客户端要求写进 MCP 配置，重启客户端生效。

Second Brain Health Check 怎么在 Claude Desktop、Cursor 里配置？

它是stdio 本地进程，客户端配置里要写启动命令和参数，运行环境是 Node.js；保存后完全退出客户端再打开，配置才会生效。

Second Brain Health Check 收费吗？

本站只整理公开资料，不代收费用，也没有标注具体价格。是否收费取决于服务本身和背后的接口额度，正式使用前按官方说明确认。

Second Brain Health Check 需要 API Key 吗？

公开资料标注为无需认证，装好就能连；如果实际调用时报鉴权错误，按官方文档补上凭据。

Second Brain Health Check 支持哪些客户端？

公开资料标注支持 Claude Desktop、Claude；其他客户端只要能配置 MCP Server，也能用同样的命令或地址接入。

来源信息

MCP World

second-brain-health-check

开源Claude代码上下文工程扫描器，提供45层检查、自适应报告和修复建议，支持本地运行和付费高级功能。

www.mcpworld.com

/detail/18005365164e9f0d89b81e60fe739e3d

参考链接

仓库入口

github.com

/iwo-szapar/second-brain-health-check

npm 包页

www.npmjs.com

/package/@iwo-szapar/second-brain-health-check

来源标签

代码分析JavaScript本地部署AI开发工具上下文工程健康检查Claude扩展

来源分类路径

代码分析

继续浏览同类 MCP

更多开发工具 MCP（20,396）返回 MCP 目录

上一个 MCP

Sec MCP F63a5d6d

一个专注于安全性的MCP技术栈，包含Open WebUI和Ollama，适用于安全测试和漏洞扫描。

下一个 MCP

Second Brain MCP

Second Brain MCP是一个本地服务器，用于索引代码和文本文件，支持通过自然语言进行语义搜索，适用于开发者快速查找和理解代码。

选型结论

安装与配置

详细介绍

安装

一个命令设置

手动MCP设置

工具

免费工具

check_health

get_fix_suggestions

generate_dashboard

generate_pdf

付费工具

weekly_pulse

context_pressure

audit_config

import_context

upgrade_brain

命令行界面

它衡量什么

工具与能力

典型使用场景

选择建议

同类对比

常见问题

Second Brain Health Check 怎么安装？

Second Brain Health Check 怎么在 Claude Desktop、Cursor 里配置？

Second Brain Health Check 收费吗？

Second Brain Health Check 需要 API Key 吗？

Second Brain Health Check 支持哪些客户端？

来源信息

继续浏览同类 MCP

`check_health`

`get_fix_suggestions`

`generate_dashboard`

`generate_pdf`

`weekly_pulse`

`context_pressure`

`audit_config`

`import_context`

`upgrade_brain`