AI导哈

AI代理协调工具

Project Brain是一款用于协调多个AI编码代理的工具，提供任务管理、对话搜索、决策跟踪和上下文传递功能，适用于开发团队提高协作效率。

  • by nihalcastelino
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 nihalcastelino/project-brain-mcp

使用说明

Project Brain MCP（免费版）

跨代码库协调多个AI代理

Cursor处理一个文件，Claude Code帮助处理另一个文件。Project Brain跟踪每个代理处理的内容，防止冲突，并使工具之间的上下文切换变得容易。

什么是Project Brain？

当你使用多个AI编码代理（Claude Desktop、Cursor、GitHub Copilot）时，很难跟踪：

  • ❌ 每个代理人都在做什么
  • ❌ 哪些对话导致了哪些代码更改
  • ❌ 开发过程中做出的重要决策
  • ❌ 如何在代理之间传递上下文

Project Brain通过以下方式解决了这个问题：

  • ✅ 任务协调 -将工作分配给特定代理
  • ✅ 对话搜索 -立即查找过去的讨论🆕
  • ✅ 决策跟踪 -记录架构选择
  • ✅ 上下文切换 -导出/导入完整项目状态🆕
  • ✅ 100%本地 -离线工作，无云依赖
  • ✅ 无供应商锁定 -完全导入/导出为JSON

免费等级：

  • ✅ 每个项目最多100个任务
  • ✅ 跨任务、对话、决策的全文搜索
  • ✅ 完全导入/导出，便于携带
  • ✅ 可与任何兼容MCP的AI工具配合使用

团队升级：

  • 🚀 无限的任务和项目
  • 🚀 具有任务锁定的多代理协调
  • 🚀 实时协作仪表板
  • 🚀 AI代码审查和分析

🚀 快速开始

安装

步骤1：配置您的AI工具

添加到您的 克劳德桌面版 config(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上， %APPDATA%\Claude\claude_desktop_config.json 在Windows上）：

{
  "mcpServers": {
    "project-brain": {
      "command": "npx",
      "args": ["-y", "@nihalcastelino/project-brain-mcp"]
    }
  }
}

对于 光标，添加到配置： ~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

步骤2：重新启动AI工具

就是这样！ npx 将在首次使用时自动下载并运行该包。

可选：全局安装以加快启动速度

npm install -g @nihalcastelino/project-brain-mcp

然后将配置更改为：

{
  "mcpServers": {
    "project-brain": {
      "command": "project-brain-mcp"
    }
  }
}

替代方案：从源代码安装

git clone https://github.com/nihalcastelino/project-brain-mcp.git
cd project-brain-mcp
npm install
npm run build

然后使用与上述相同的配置，但更改命令以指向您的本地安装。

用法

配置后，在AI对话中使用这些MCP工具：

# Create a project
pb_create_project(name="My App", description="Building a web app")

# Create a task
pb_create_task(projectId="...", title="Implement auth", priority="high")

# List tasks
pb_list_tasks(projectId="...")

# Complete a task
pb_complete_task(taskId="...")

# Export project to Markdown
pb_export_project(projectId="...", format="markdown")

📖 详细功能

🔍 全文搜索（新增！）

  • 搜索任务 -按标题、描述或注释查找任务
  • 搜索对话 -立即查找过去的讨论
  • 搜索决策 -快速定位架构选择
  • 项目范围 -搜索所有项目或按项目筛选
  • 快速SQLite搜索 -每个查询最多50个结果

例子：

pb_search_conversations({ query: "JWT authentication error" })
// Returns all conversations mentioning JWT auth issues

💾 导入/导出（新增！）

  • 完成项目备份 -将所有内容导出为JSON
  • 从备份中恢复 -导入具有完整历史记录的项目
  • 无供应商锁定 -您的数据是可移植的
  • 尊重限度 -导入在免费层中停止100个任务

例子：

// Export project
pb_export_project_json({ projectId: "proj-123" })

// Import to new environment
pb_import_project({ data: backupData })

📋 任务管理

  • 创建、读取、更新、删除任务
  • 设定优先级（低、中、高）和截止日期
  • 跟踪状态（待办、进行中、已完成、已阻止）
  • 分配给特定的AI代理 （克劳德、光标、副驾驶）
  • 每个项目100个任务（免费层）

🗂️ 项目组织机构

  • 将相关任务分组到项目中
  • 按状态、优先级、受让人、截止日期筛选任务
  • 将整个项目导出为Markdown或JSON格式

💬 对话记录

  • 跟踪有关任务的AI讨论
  • 记录用户、助手和系统消息
  • 附加结构化元数据（代码片段、错误等）
  • 可搜索历史记录 -查找任何过去的对话

✅ 决策跟踪

  • 记录重要的技术决策
  • 提供多项选择或自由形式的答案
  • 追踪谁做出了决定以及为什么
  • 将决策与任务和对话联系起来

💎 升级到团队版

为什么要升级？

如果您满足以下条件，您将需要Team Edition：

  • 👥 与他人合作 使用不同的人工智能工具（光标+克劳德+副驾驶）

    • 团队版添加 任务锁定 所以代理人不会冲突
    • 实时在场 -看看谁在做什么
    • 实时协作 -查看团队成员的终端输出

  • 🤖 需要人工智能驱动的见解

    • AI代码审查 -Claude Sonnet 4检查每个提交
    • 会话分析 -自动总结和见解
    • 及时的高质量辅导 -改进您使用AI的方式

  • 🌿 想要高级Git功能

    • Git工作树 -每个任务自动隔离分支
    • 质量门 -合并前必须通过测试
    • 冲突预防 -永远不要覆盖对方的工作

  • 📊 需要项目可见性

    • 实时仪表盘 -带有拖放功能的看板
    • 动态消息 -实时查看所有团队行动
    • 分析 -跟踪团队生产力和人工智能使用情况

  • 🚀 达到100个任务限制

    • 团队版有 无限的任务和项目
    • 无缝导入备份

不仅仅是“更多的任务”，它还涉及协调多个代理和人类协同工作。

定价

  • 免费等级：$0/月-100个任务/项目，单用户，仅限本地
  • 团队版：20美元/用户/月（每年）-无限制的一切+协作
  • 试用：14天免费，无需信用卡

开始免费试用→

🛠️ 发展

克隆和构建

git clone https://github.com/nihalcastelino/project-brain-mcp.git
cd project-brain-mcp
npm install
npm run build

本地测试

npm run dev

📚 MCP工具参考

项目

  • pb_create_project -创建新项目
  • pb_list_projects -列出所有项目
  • pb_get_project -获取项目详细信息
  • pb_update_project -更新项目名称/描述
  • pb_delete_project -删除项目

任务

  • pb_create_task -创建新任务（免费限制：100个/项目）
  • pb_list_tasks -列出所有任务（带过滤器）
  • pb_get_task -获取任务详细信息
  • pb_update_task -更新任务详细信息
  • pb_complete_task -将任务标记为已完成
  • pb_delete_task -删除任务

对话

  • pb_create_conversation -开始对话
  • pb_log_message -记录消息（用户/助理/系统）
  • pb_get_conversation -获取对话详细信息
  • pb_get_messages -获取所有消息
  • pb_list_conversations -列出对话
  • pb_delete_conversation -删除对话

决策

  • pb_create_decision -创建决策点
  • pb_answer_decision -回答一个决定
  • pb_list_decisions -列出决策

🔍 搜索（新增！）

  • pb_search_tasks -按关键字（标题、描述、注释）搜索任务
  • pb_search_conversations -按关键字（标题、消息）搜索对话
  • pb_search_decisions -按关键字（问题、答案、理由）搜索决策

💾 导入/导出

  • pb_export_project -将项目导出到Markdown/聊天/纯文本
  • pb_export_task -导出带有对话的任务
  • pb_export_conversation -导出对话
  • pb_export_project_json -将完整的项目备份导出为JSON（新增！）
  • pb_import_project -从JSON备份导入项目（新增！）

效用

  • pb_ping -测试MCP连接

🗄️ 数据存储

免费等级： 所有数据都存储在SQLite数据库中：

  • macOS： ~/.project-brain/project-brain.db
  • Linux： ~/.project-brain/project-brain.db
  • 窗户： %USERPROFILE%\.project-brain\project-brain.db

没有云同步。 你的数据永远不会离开你的机器。

🤝 贡献

我们欢迎捐款！注：

  • 这个免费等级是 100%开源 （MIT许可证）
  • Team Edition功能在单独的商业产品中

贡献：

  1. 分叉回购
  2. 创建要素分支
  3. 进行更改
  4. 提交拉取请求

请确保：

  • 代码遵循现有样式
  • 测试通过（如适用）
  • README已更新（如果需要）

📄 许可证

MIT许可证 -请参阅 许可证 详见

这意味着您可以：

  • ✅ 商业用途
  • ✅ 修改
  • ✅ 分发
  • ✅ 私下使用

🆘 支持

免费等级（社区支持）：

付费级别（优先支持）：

  • 电子邮件：support@project-brain.io
  • 响应时间：<24小时
  • 专用Slack频道

🔗 链接

⭐ 明星我们！

如果你觉得Project Brain有帮助，请在仓库上加星！

它帮助其他人发现项目，并激励我们不断改进。

由...制作❤️ 由大脑项目团队

帮助AI代理协作，一次完成一项任务。

相关 MCP