Branch Thinking MCP

🚦 分支思维MCP工具

最新动态（2025-04）： - 高级可视化：聚类（k-means/dree）、中心覆盖、边缘捆绑和任务和优先级的代理覆盖 - 代理缓存和预取：用于嵌入、摘要、分析和主动代理缓存预热的LRU+TTL缓存 - 增强的分析：实时、多分支和focusNode支持；代理优化元数据 - 升级了代理和用户的文档和入职培训

______________________________________________________________________

特性

• 🌳 分行管理： 创建、集中和导航多条思路
• 🔗 交叉引用： 跨分支链接相关想法（键入、评分）
• 💡 AI洞察： 自动洞察和摘要生成
• 🧠 语义搜索： 使用嵌入查找相关想法
• 📊 高级可视化：

- 节点聚类（k-means/度） - 中心性叠加（紧密性、中间性） - 边缘捆绑 - 任务叠加（状态、优先级、下一步行动） - 所有节点/边的代理覆盖和元数据 - FocusNode和多分支可视化

• ⚡ 代理缓存和预回迁：

- 用于嵌入、摘要和分析的LRU+TTL缓存 - 代理工作流的主动缓存预热

• 🗂️ 永久存储： 可查询、可扩展、永不丢失思想
• 🔄 实时和多分支： 实时可视化和分析多个分支和节点
• 🛠️ 生产等级： 强大的错误处理、性能优化和对代理/人类友好的API

______________________________________________________________________

🛠️ 技术栈

• Node.js (18+)
• TypeScript （4.x）
• @dagrejs/graphlib：图形结构、算法和分析
• ml kmeans：用于可视化的聚类
• lru缓存：用于嵌入、摘要、分析的LRU+TTL缓存
• @xenova/变压器：嵌入和汇总管道
• @模型上下文协议/sdk：MCP协议和代理集成
• 粉笔：CLI输出样式
• 美人鱼：甘特图/路线图可视化
• pnpm：快速依赖关系管理

______________________________________________________________________

路线图（甘特图）

gantt
    title Branch-Thinking MCP Roadmap (2025)
    dateFormat  YYYY-MM-DD
    section Q2 2025
    Advanced Visualization/Analytics :done,      vis1, 2025-04-01,2025-04-20
    Agentic Cache & Prefetch         :done,      cache1, 2025-04-10,2025-04-22
    Enhanced Agentic Docs            :done,      doc1, 2025-04-15,2025-04-25
    Real-time Collaboration          :active,    collab1, 2025-04-20,2025-06-01
    Web Visualization Dashboard      :active,    webviz1, 2025-04-25,2025-06-15
    section Q3 2025
    Plugin System                    :planned,   plugin1, 2025-06-15,2025-07-15
    Mobile/Tablet UI                 :planned,   mobile1, 2025-07-01,2025-08-01
    AI Branch Merging                :planned,   merge1, 2025-07-15,2025-08-15
    Knowledge Base Sync              :planned,   sync1, 2025-08-01,2025-09-01

______________________________________________________________________

目录

• 为什么要分支思考？
• 总结
• 特性
• 快速开始
• 入门指南
• 真实世界使用食谱
• 架构与流程
• 路线图（甘特图）
• 测试与质量
• 安全
• 可访问性和国际化
• 故障排除和常见问题
• 最佳实践
• 贡献
• 更新日志
• 参考文献和相关项目
• 鸣谢
• 许可证

______________________________________________________________________

为什么要分支思考？

• 设计代理： 为人类和人工智能工作流程而构建——每个命令都对代理友好。
• 真正的分支： 并行组织、交叉链接和推理想法、代码和任务。
• 人工智能原生 语义搜索、自动摘要和开箱即用的洞察生成。
• 持久视觉： 永远不要失去一个想法——一切都是可查询、可可视化和可扩展的。

总结

分支思维MCP工具 是一个高级代理平台，用于管理、可视化和推理分支思想、任务、代码和知识。它使人工智能代理和人类能够组织复杂的项目，交叉链接想法，并使用强大的基于分支的范式自动生成洞察力。通过语义搜索、可视化和持久任务/代码管理，它专为下一代协作和自主工作流而设计。

分支思维MCP工具 是一个高级代理平台，用于管理、可视化和推理分支思想、任务、代码和知识。它使人工智能代理和人类能够组织复杂的项目，交叉链接想法，并使用强大的基于分支的范式自动生成洞察力。通过语义搜索、可视化和持久任务/代码管理，它专为下一代协作和自主工作流而设计。

______________________________________________________________________

架构与流程

flowchart TD
    User([User/Agent 🤖])
    CLI([CLI/API])
    BM[BranchManager 🧠]
    EmbCache[[Embedding/Summary Cache]]
    Storage[(Persistent Storage 💾)]
    Viz([Visualization/Analytics])
    Tasks([Task Extraction])
    Snippets([Code Snippet Storage])

    User-->|Commands/Queries|CLI
    CLI-->|Manage/Query|BM
    BM-->|Cache|EmbCache
    BM-->|Save/Load|Storage
    BM-->|Visualize|Viz
    BM-->|Tasks|Tasks
    BM-->|Snippets|Snippets
    BM-->|Results|CLI
    CLI-->|Output|User

______________________________________________________________________

快速开始

在几秒钟内起床并跑步：

pnpm install  # Recommended for speed (or npm install)
pnpm build
node dist/index.js --help  # See available commands

______________________________________________________________________

入门指南

1.克隆和安装

git clone https://github.com/your-org/branch-thinking-mcp.git
cd branch-thinking-mcp
pnpm install  # Or npm install
pnpm build   # Or npm run build

2.配置（可选）

对于Claude Desktop集成，请添加到您的 claude_desktop_config.json:

"branch-thinking": {
  "command": "node",
  "args": [
    "/your-custom-mcp-dir-here/branch-thinking/dist/index.js"
  ]
}

3.跑步

node dist/index.js

______________________________________________________________________

真实世界使用食谱

1.知识获取和链接

# Batch capture meeting notes
add-thought dev "Discussed semantic search improvements" note
add-thought dev "Agreed to refactor API" decision
# Link related thoughts
link-thoughts t1 t2 supports "API refactor supports search improvements"

2.代理任务提取

# Extract and manage tasks from a research branch
extract-tasks research
list-tasks research open
update-task-status task-1 in_progress

3.洞察可视化

# Generate and interpret a knowledge graph
visualize dev
# Review AI-generated summary
summarize-branch dev

______________________________________________________________________

🧑‍💻 实时示例：代理工作流

# 1. Create a new branch for your project or idea
create-branch "AI Research"

# 2. Add thoughts and observations
add-thought [branchId] "Explore semantic search for agent workflows" analysis
add-thought [branchId] "Test cross-linking and summarization" observation

# 3. Link related thoughts
link-thoughts [thoughtId1] [thoughtId2] supports "Thought 2 validates Thought 1"

# 4. See your knowledge graph
visualize [branchId]

# 5. Extract tasks and get AI review
extract-tasks [branchId]
review-branch [branchId]

替换 [branchId] 和 [thoughtIdX] 实际ID来自 list 和 history.

______________________________________________________________________

命令参考

分行管理

思维与洞察力管理

任务管理

人工智能与知识

最佳实践

• 始终从以下内容开始 create-branch 以确保上下文干净。
• 使用 list 和 focus 在项目或思路之间导航。
• 杠杆作用 summarize-branch 和 insights 在添加了几个想法以获得AI生成的上下文后。
• 使用 link-thoughts 显式地连接想法、任务或代码，以获得更丰富的语义图。
• 代码更改后，始终运行 pnpm lint 和 pnpm build 及早发现错误。
• 将复杂的目标分解为思想/任务/洞察力命令的序列。
• 迭代和调整：使用总结、评论和可视化的反馈来完善下一步行动。
• 明确指定参数（branchId、状态、受让人等）以获得精确的结果。
• 使用交叉引用和多跳链接来培养创造力和沟通想法。
• 提示代理人（克劳德、GPT-4等）“逐步思考”或“使用思维链”以获得最佳结果。

安全

• 所有持久数据都存储在本地（默认：项目目录或 MCP_STORAGE_PATH)
• 除非已配置，否则不进行外部API调用
• 代理/用户负责存储的想法和任务的隐私
• 要报告安全问题，请 打开一个问题 或给维护人员发电子邮件。

故障排除和常见问题

Q： 工具没有响应！ A： 检查MCP服务器日志，确保配置正确。

Q： 如何重置存储？ A： 删除或移动持久存储目录（请参阅配置）。

Q： 如何添加新命令？ A： 扩展 handleCommand 在……里面 src/index.ts 并将其记录在README中。

可访问性和国际化

• 所有徽章/图像都有描述性的alt文本。
• 默认语言为英语；欢迎为翻译提供意见。
• 如果您想帮助本地化此工具，请打开一个PR或问题。

贡献

欢迎投稿、问题和功能请求！请在GitHub上打开PR或问题。

1. 分叉此回购
2. 创建新分支(git checkout -b feature/your-feature)
3. 提交您的更改
4. 推到分支
5. 打开拉取请求

参考文献和相关项目

• 模型上下文协议（MCP）
• 顺序思维工具
• 黑曜石
• Logseq

______________________________________________________________________

鸣谢

• 概念和测试： @ssdeanx
• 核心代码生成： 克劳德、GPT-4和喀斯喀特
• 实施、修复和文档： @ssdeanx

______________________________________________________________________

许可证

麻省理工学院