SecondBrain MCP

Read-only MCP-сервер для Obsidian vault. Даёт AI-ассистентам (Claude, ChatGPT и др.) семантический доступ к заметкам, проектам, решениям и задачам.

Что умеет

Вместо сырого доступа к файлам предоставляет структурированные инструменты:

| Tool | Описание | |------|----------| | healthcheck | Статус vault и статистика | | search_knowledge | Полнотекстовый поиск + фильтры по frontmatter | | get_note | Чтение заметки по пути или имени | | list_projects | Список проектов с фильтром по статусу | | get_project_context | Полный контекст проекта: содержимое + связи + задачи + решения | | find_related | Связанные заметки через wikilinks, backlinks, общие теги | | extract_tasks | Открытые/завершённые задачи из vault или папки | | extract_decisions | Записи из журнала решений |

Установка

git clone <repo-url> && cd sb-mcp
npm install
npm run build

Запуск

Stdio (локально, один клиент)

OBSIDIAN_VAULT_PATH=/path/to/vault node dist/index.js

HTTP (удалённо, несколько клиентов)

OBSIDIAN_VAULT_PATH=/path/to/vault \
MCP_AUTH_TOKEN=your-secret-token \
MCP_PORT=3100 \
node dist/index.js --http

Аутентификация

В HTTP-режиме задайте переменную MCP_AUTH_TOKEN для защиты доступа. Токен можно передать двумя способами:

1. Заголовок Authorization — для клиентов с поддержкой кастомных заголовков (Claude Code, API-клиенты):

Authorization: Bearer your-secret-token

2. Query-параметр — для клиентов без поддержки заголовков (Claude.ai, ChatGPT):

https://your-server/mcp?token=your-secret-token

Если MCP_AUTH_TOKEN не задан, сервер работает без аутентификации (не рекомендуется для публичных сетей).

Сгенерировать токен:

openssl rand -hex 32

Переменные окружения

| Переменная | По умолчанию | Описание | |------------|-------------|----------| | OBSIDIAN_VAULT_PATH | текущая директория | Путь к Obsidian vault | | MCP_TRANSPORT | stdio | Режим транспорта: stdio или http | | MCP_PORT | 3100 | Порт HTTP-сервера | | MCP_AUTH_TOKEN | — | Токен для аутентификации в HTTP-режиме |

Настройка клиентов

Claude Code (.mcp.json)

Stdio (локально):

{
  "mcpServers": {
    "secondbrain": {
      "command": "node",
      "args": ["/path/to/sb-mcp/dist/index.js"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/vault"
      }
    }
  }
}

HTTP (удалённо):

{
  "mcpServers": {
    "secondbrain": {
      "type": "url",
      "url": "https://your-server/mcp",
      "headers": {
        "Authorization": "Bearer your-secret-token"
      }
    }
  }
}

Claude.ai / ChatGPT

Используйте URL с токеном в query-параметре:

https://your-server/mcp?token=your-secret-token

systemd (деплой на сервер)

# /etc/systemd/system/secondbrain-mcp.service
[Unit]
Description=SecondBrain MCP Server
After=network.target

[Service]
Type=simple
ExecStart=/usr/bin/node /path/to/sb-mcp/dist/index.js --http
Environment=OBSIDIAN_VAULT_PATH=/path/to/vault
Environment=MCP_AUTH_TOKEN=your-secret-token
Environment=MCP_PORT=3100
Restart=on-failure

[Install]
WantedBy=multi-user.target

Контракт данных

• Исключённые папки: .git, .obsidian, node_modules, 99_Private, _attachments, mcp
• Типы заметок: project, area, resource, person, daily, moc, decision, inbox, about
• Статусы: active, paused, done, someday
• Frontmatter: YAML с полями type, status, created, updated, tags, aliases, related
• Связи: [[wikilinks]] + related: в frontmatter + backlinks + общие теги