Team Vault MCP

Team Vault MCP

MCP-сервер, который отдаёт REST API Team Vault как набор инструментов для ИИ-агентов. Позволяет другим агентам читать и править заметки вальта программно, без Obsidian — поверх того же серверного API, что использует плагин.

Транспорт — stdio (агент запускает процесс и общается по JSON-RPC). Аутентификация — заголовок X-API-Key.

Конфигурация (env)

| Переменная | Обяз. | Описание | | ----------------------- | ----- | ---------------------------------------------------------------------- | | TEAM_VAULT_URL | да | URL сервера, напр. https://obsidian.artillect.pro | | TEAM_VAULT_API_KEY | да | API-ключ Team Vault (веб-UI → API-ключи) | | TEAM_VAULT_PROJECT_ID | нет | проект по умолчанию для инструментов без projectId | | TEAM_VAULT_READ_ONLY | нет | 1/true — отключить запись (write_note/move_note/delete_note) |

Инструменты

| Инструмент | Режим | Что делает | | -------------------- | ------ | ------------------------------------------------ | | whoami | чтение | владелец API-ключа | | list_projects | чтение | доступные проекты (id, slug, name) | | list_notes | чтение | пути файлов проекта (prefix — фильтр по папке) | | read_note | чтение | содержимое текстовой заметки по пути | | list_note_versions | чтение | история версий файла | | write_note | запись | создать/перезаписать заметку по пути | | move_note | запись | переместить/переименовать | | delete_note | запись | мягко удалить (tombstone, восстановимо) |

Инструменты путь-ориентированы: агент оперирует путями (персонажи/кузьма-минин.md), а MCP сам резолвит путь ↔ fileId. В read_only-режиме инструменты записи не регистрируются вовсе.

Сборка и запуск

pnpm install
pnpm build          # tsup → dist/index.js (один бандл)
TEAM_VAULT_URL=… TEAM_VAULT_API_KEY=… node dist/index.js

Гейты: pnpm typecheck && pnpm format:check && pnpm build.

Подключение в Claude Code / MCP-клиенте

{
  "mcpServers": {
    "team-vault": {
      "command": "node",
      "args": ["/абсолютный/путь/TeamVaultMCP/dist/index.js"],
      "env": {
        "TEAM_VAULT_URL": "https://obsidian.artillect.pro",
        "TEAM_VAULT_API_KEY": "osync_…",
        "TEAM_VAULT_PROJECT_ID": "cmq…"
      }
    }
  }
}

Лицензия

MIT · krem.digital