# hivemind

Подключает локальные базы Obsidian к ИИ-ассистентам через MCP. Помогает модели сверяться с каноническими заметками вместо выдумывания фактов.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10
- Автор: hiveforge-sh
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/hiveforge-sh/hivemind
- Обновлён: 2026-10-21
- HTML: https://affpapa.org/nevibecode/mcp/hivemind

## Что делает

Сервер превращает файлы Obsidian в источник проверенных данных для Claude Code, Codex или Cursor. Модель обращается к markdown-документам с YAML-разметкой и wikilinks, извлекая факты о сущностях. Внутри предусмотрены готовые структуры для сценариев, архитектуры ПО с ADR-записями, академических исследований и рабочих встреч.

В основе лежит система статусов канона: заметки делятся на черновики, ожидающие проверки и утверждённые материалы. Без указания пути к хранилищу через переменную `HIVEMIND_VAULT_PATH` сервер работать не сможет. Все данные обрабатываются на вашей машине без отправки на внешние серверы автора.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `HIVEMIND_VAULT_PATH`, `HIVEMIND_CONFIG_PATH` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env HIVEMIND_VAULT_PATH=<HIVEMIND_VAULT_PATH> --env HIVEMIND_CONFIG_PATH=<HIVEMIND_CONFIG_PATH> --transport stdio hivemind -- npx -y @hiveforge/hivemind-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add hivemind --env HIVEMIND_VAULT_PATH=<HIVEMIND_VAULT_PATH> --env HIVEMIND_CONFIG_PATH=<HIVEMIND_CONFIG_PATH> -- npx -y @hiveforge/hivemind-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hivemind": {
            "command": "npx",
            "args": [
                "-y",
                "@hiveforge/hivemind-mcp"
            ],
            "env": {
                "HIVEMIND_VAULT_PATH": "<HIVEMIND_VAULT_PATH>",
                "HIVEMIND_CONFIG_PATH": "<HIVEMIND_CONFIG_PATH>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "hivemind": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@hiveforge/hivemind-mcp"
            ],
            "env": {
                "HIVEMIND_VAULT_PATH": "<HIVEMIND_VAULT_PATH>",
                "HIVEMIND_CONFIG_PATH": "<HIVEMIND_CONFIG_PATH>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e HIVEMIND_VAULT_PATH=<HIVEMIND_VAULT_PATH> -e HIVEMIND_CONFIG_PATH=<HIVEMIND_CONFIG_PATH> hivemind npx -y @hiveforge/hivemind-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- ограничить выдумки модели утверждёнными записями из хранилища Obsidian
- передать контекст архитектурных решений ADR в ассистент кодинга
- фильтровать факты по статусам готовности от черновика до канона
- подтягивать данные о персонажах и связях сущностей при генерации текста

## Примеры запросов агенту
- Проверь по заметкам в Obsidian, какие ограничения заданы для модуля авторизации.
- Найди утверждённых персонажей из фракции магов и перечисли их связи.
- Уточни в базе архитектурные решения по выбору базы данных перед написанием кода.

## Похожие
- [worldbuilding](https://affpapa.org/nevibecode/skills/worldbuilding.md) — скилл · 912 установок
- [shared-world](https://affpapa.org/nevibecode/skills/shared-world.md) — скилл · 453 установки
- [llm-wiki](https://affpapa.org/nevibecode/skills/ar9av-llm-wiki.md) — скилл · 4100 установок
- [wiki-update](https://affpapa.org/nevibecode/skills/wiki-update.md) — скилл · 3400 установок
- [moc-agent](https://affpapa.org/nevibecode/agents/moc-agent.md) — субагент · 666 установок
- [obsidian-markdown](https://affpapa.org/nevibecode/skills/agricidaniel-obsidian-markdown.md) — скилл · 545 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md