mcpField
H
hivemind

hivemind

本地服务
github.com/hiveforge-sh记忆与知识104 天前更新
代码仓库

关于 hivemind

hivemind 是面向 Obsidian Vault 的本地优先插件，为世界构建者、研究者和团队提供结构化笔记管理与可视化。它让 AI 工具查询 Vault 中的既有内容，并通过规范状态流程帮助保持内容一致。

主要功能

  1. 01Obsidian 笔记结构化访问
  2. 02时间线与关系图可视化
  3. 03草稿、待审与规范状态流程
  4. 04世界构建、研究等模板
  5. 05支持自定义实体类型
  6. 06数据保留在本机

适用场景

  1. 01追踪小说角色、地点与事件
  2. 02查询研究笔记并探索概念关联
  3. 03记录团队目标和会议背景
  4. 04整理系统组件与架构决策

MCP 相关

提供兼容 MCP 的服务端，让 Claude、GitHub Copilot 等 AI 工具查询 Obsidian Vault。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "hiveforge-sh-hivemind": {
      "command": "npx",
      "args": [
        "-y",
        "@hiveforge/hivemind-mcp"
      ],
      "env": {
        "HIVEMIND_VAULT_PATH": "<HIVEMIND_VAULT_PATH>",
        "HIVEMIND_CONFIG_PATH": "<HIVEMIND_CONFIG_PATH>"
      }
    }
  }
}
启动命令npx -y @hiveforge/hivemind-mcp
需要配置的环境变量
HIVEMIND_VAULT_PATHPath to your Obsidian vault directory
HIVEMIND_CONFIG_PATHPath to optional Hivemind config file

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@hiveforge/hivemind-mcp3.6.3

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Obsidian 版 Hivemind

Obsidian 版 Hivemind

License: MIT

你的正典就是事实来源。AI 不会越界。

为什么选择 Hivemind？

在构建虚构世界时——无论是写小说、设计游戏，还是主持 RPG 战役——AI 工具都可以成为强大的协作者。但它们会产生幻觉。向 AI 助手询问你上周创建的角色，它可能会编造与既定正典相矛盾的细节。

Hivemind 通过为 AI 工具提供结构化的 Obsidian 库访问权限来解决这个问题。可以把它看作一层 AI 防火墙：你的世界构建笔记会成为事实锚点，让 AI 以你掌控的事实为依据。询问某个角色时，AI 读取的是你的实际笔记，而不是幻觉生成的版本。查询时间线时，它引用的是你已确定的事件，而不是编造的日期。

除了 AI 集成，Hivemind 还提供强大的可视化工具：

  • 时间线视图 — 按时间顺序查看故事事件
  • 关系图视图 — 探索角色、地点、派系等之间的关系
  • 正典工作流 — 跟踪内容已获批准、正在审核，还是仍为草稿

Hivemind 专为世界构建者打造，但同样的原则也适用于研究库、人员管理、软件架构等任何需要 AI 尊重既有知识的场景。

功能

  • 时间线视图 — 按时间顺序直观呈现事件，并支持筛选和搜索
  • 关系图视图 — 通过交互式可视化探索实体关系
  • AI 集成 — 兼容 MCP 的服务，可用于 Claude、GitHub Copilot 和其他 AI 工具
  • 可插拔模板 — 内置世界构建、研究、人员管理等模板
  • 正典工作流 — 草稿 → 待处理 → 正典的审批系统，并带有一致性验证
  • Obsidian 原生支持 — 兼容标准 Markdown、YAML frontmatter 和 wikilink
  • 本地优先 — 你的数据保留在自己的设备上
内置模板
模板适用场景实体类型
世界构建小说作者、游戏设计师、RPG 创作者角色、地点、事件、派系、背景知识、素材
研究学者、知识工作者论文、引文、概念、笔记
人员管理经理、团队负责人人员、目标、团队、一对一会议
软件架构工程师、架构师系统、组件、ADR、约束

通过配置定义自己的自定义实体类型——无需编写代码。详情请参阅 CONTRIBUTING_TEMPLATES.md。

安装

Obsidian 插件（推荐）
  1. 打开 Obsidian 设置
  2. 前往社区插件 → 浏览
  3. 搜索「Hivemind」
  4. 点击安装，然后启用
手动安装
  1. 从 GitHub Releases 下载最新版本
  2. 解压到你的库的 .obsidian/plugins/hivemind 目录
  3. 重新加载 Obsidian，并在设置中启用插件
AI 集成（可选）

想让 AI 工具查询你的库？请设置 MCP 服务：

MCP 设置指南 →

指南涵盖：

  • Claude Desktop 配置（Windows、macOS、Linux）
  • GitHub Copilot 配置
  • 模板选择
  • 故障排除

快速开始

  1. 选择模板 — 在 Obsidian 中打开 Hivemind 设置并选择一个模板（世界构建、研究等）

  2. 创建实体 — 像往常一样使用 Obsidian 创建笔记。添加 YAML frontmatter 以定义实体类型：

    ---
entity_type: character
canon_status: draft
---

  3. 可视化 — 从功能区图标打开时间线视图或关系图视图

  4. 连接 AI — 按照 MCP 设置指南 操作，让 AI 工具查询你的库

如需详细的设置说明，请参阅 docs/SETUP_GUIDE.md。

截图

时间线视图

即将推出 — 按时间顺序可视化事件

时间线视图占位图

图谱视图

即将推出 — 交互式实体关系可视化

图谱视图占位图

使用场景

世界构建：

  • 跟踪小说中的角色、地点和事件
  • AI 在协助撰写对话时会记住角色详情
  • 可视化故事中关键事件的时间线

研究：

  • 整理所在领域的论文、引用和概念
  • AI 回答问题时会参考实际研究内容
  • 探索知识库中各个概念之间的联系

人员管理：

  • 跟踪团队目标、一对一会议记录和人员详情
  • AI 起草议程时会回忆此前会议的背景信息
  • 可视化团队关系和汇报架构

软件架构：

  • 记录系统、组件和架构决策（ADR）
  • AI 提出设计模式建议时会参考 ADR
  • 以可视化方式跟踪组件之间的依赖关系

文档

社区

贡献

欢迎贡献！请参阅 CONTRIBUTING.md 了解指南。

重要提示：本项目使用 Conventional Commits。提交消息必须遵循以下格式：

<type>: <description>

[optional body]

常见类型：feat、fix、docs、style、refactor、test、chore

许可证

MIT — 可免费用于个人和商业用途。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。