 ](https://www.npmjs.com/package/@brief-md/mcp) 
mcp简介
MCP服务器 BRIEF.md --聊天时的记事本，以及开始新会话时的引导加载程序。
问题
当你在人工智能聊天中计划一个复杂的项目时，你会做出决定，设定约束，明确方向。随着对话的增长，人工智能会压缩它来管理上下文窗口，保持它认为重要的东西——这并不总是对你重要的东西。
开始一个新的会话意味着重新解释项目，或者复制旧的对话，这会用你不需要的东西填充新的上下文。休息后回来，你个人也会遇到同样的问题——意图和决定都在你的脑海中，或者分散在文档和聊天记录中。
mcp如何解决这个问题
当你聊天时， brief-mcp 将决策、约束和开放性问题整理成结构化 BRIEF.md 文件在后台。当你回到一个项目时，它会自动加载该上下文——你开始简报，而不是空白。
因为BRIEF.md只是一个文件，任何工具都可以读取它。在ChatGPT中规划，在Cursor中编码，在Claude中查看——所有这些都引用了相同的BRIEF.md.它已经被提炼并准备好了，而不是在漫长的聊天历史中寻找真正重要的东西。
README解释了项目是如何工作的。BRIEF.md捕捉到了它是什么以及它存在的原因。
特性
- 57个MCP工具 --对BRIEF.md项目上下文的完全读/写访问权限
- 层次感知上下文 --向上遍历嵌套的BRIEF.md文件以构建完整上下文
- 本体系统 --安装、搜索、浏览和标记域知识包
- 参考系统 --反向索引参考文献及建议
- 冲突检测 --决策和约束之间的表面矛盾
- 类型指南和扩展 --通用核心之上的领域特定结构
- 生命周期跟踪 --成熟度信号和阶段感知微调
- 适用于任何域名 --软件、音乐、电影、研究、建筑、商业——核心格式扩展以适应
全部文件：参见 docs/ 完整手册的目录，包括工具参考、交互模式和指南。
需求
- Node.js>=20.0.0
安装
重要提示： npm包是@brief-md/mcp，不brief-mcp.未放映的brief-mcpon npm是一个无关的项目。
npm install -g @brief-md/mcp或者直接与npx一起使用：
npx @brief-md/mcp快速开始
1.添加到您的MCP客户端
克劳德桌面版 --添加到 claude_desktop_config.json:
{
"mcpServers": {
"brief-mcp": {
"command": "npx",
"args": ["-y", "@brief-md/mcp"]
}
}
}克劳德代码:
claude mcp add brief-mcp -- npx --yes @brief-md/mcp光标 --设置>MCP服务器，添加：
{
"brief-mcp": {
"command": "npx",
"args": ["-y", "@brief-md/mcp"]
}
}帆板运动 --与Cursor类似的stdio配置。
2.注册工作区
告诉客服注册您的项目目录：
“将~/projects添加为简短的mcp工作区”
3.创建或重新输入项目
“为我的项目创建一个新的BRIEF.md”或“重新输入我的项目”
这 brief_reenter_project 该工具返回一个结构化的摘要——身份、决策、问题、冲突、生命周期阶段和下一步——这样代理就可以从您停止的地方继续。
工具
服务器通过MCP公开57个工具，按域组织。看 文档/工具/ 获取完整的参数文档和示例。
| 类别 | 工具 | 描述 |
|---|---|---|
| 工作区和会话 | 9 | 项目创建、重新进入、工作空间管理 |
| 上下文阅读 | 4 | 阅读上下文、约束、决策、问题 |
| 上下文编写 | 6 | 记录决策、问题、更新部分 |
| 验证 | 2 | 毛发和冲突检测 |
| 层级 | 2 | 位置和树状图 |
| 本体论 | 17 | 搜索、浏览、标记、安装、创建包 |
| 参考文献 | 5 | 添加、查找、建议参考文献 |
| 扩展和类型指南 | 9 | 扩展、类型指南、结构化部分 |
| 发现与分析 | 3 | 框架、成熟度、注册表搜索 |
MCP资源
| URI | 描述 |
|---|---|
brief://guide | AI交互指南，包含11种模式、决策规则和问题规则 |
运输
brief-mcp 通过以下方式进行通信 标准 （JSON-RPC通过标准输入/标准输出）。MCP客户端将服务器作为子进程生成——两者必须在同一台机器上运行。
这能实现什么：
- 通过Claude Desktop、Claude Code、Cursor或任何stdio MCP客户端进行本地使用
- 通过SSH或远程终端远程使用（例如SSH上的Claude Code）
这无法实现以下功能：
- 从另一台机器或移动设备直接访问网络
- 作为独立持久服务运行
看 docs/transport.md 远程访问选项和HTTP传输路线图。
文档
| 指南 | 说明 |
|---|---|
| 入门指南 | 安装、客户端设置、第一个项目 |
| 核心概念 | BRIEF.md格式、层次结构、生命周期、扩展 |
| 工具参考 | 所有57个带有参数和示例的工具 |
| 交互模式 | 人工智能辅助工作流程的11种模式 |
| 决策规则 | DR-01至DR-09 |
| 提问规则 | 问题01至问题12 |
| 本体系统 | 包装、标签、结构化部分 |
| 扩展 | 内置和自定义扩展 |
| 类型指南 | 特定领域的项目模板 |
| 配置 | 配置文件、环境变量、CLI标志 |
| 运输 | stdio、远程访问、HTTP路线图 |
| 故障排除 | 常见问题和调试 |
发展
npm install # Install dependencies
npm run build # Build for production
npm test # Run tests
npm run lint # Lint (Biome)
npm run typecheck # Type check (tsc)
npm run dev # Watch mode看 贡献.md 发展指南。
安全
看 安全.md 用于漏洞报告策略和安全设计。
服务器对所有操作强制执行路径验证、输入净化和资源限制。不进行外部HTTP或AI API调用。