AI导哈

笔记项目上下文管理服务器

brief-mcp是一个用于管理BRIEF.md项目上下文的服务器，能够在聊天时自动记录决策、约束和开放性问题，并在新会话中自动加载这些上下文。

  • by brief-md
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 brief-md/brief-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-mcp on 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调用。

社区

许可证

麻省理工学院

相关 MCP