Team Vault

БесплатноНе проверен

Exposes Team Vault's REST API as MCP tools for AI agents, enabling programmatic reading and editing of notes without Obsidian.

автор: kremdigital

GitHub Embed

Описание

Exposes Team Vault's REST API as MCP tools for AI agents, enabling programmatic reading and editing of notes without Obsidian.

README

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

from github.com/kremdigital/TeamVaultMCP

Установить Team Vault в Claude Desktop, Claude Code, Cursor

Рекомендуется · одна команда, все IDE

unyly install team-vault-mcp

Ставит в Claude Desktop, Claude Code, Cursor и VS Code — сам разбирается с npx, uvx и сборкой из исходников.

Впервые? Поставь CLI: curl -fsSL https://unyly.org/install | sh

Или настроить вручную

Выполни в терминале:

claude mcp add team-vault-mcp -- npx -y github:kremdigital/TeamVaultMCP

FAQ

Team Vault MCP бесплатный?

Да, Team Vault MCP бесплатный — установка в пару кликов через Unyly без оплаты.

Нужен ли API-ключ для Team Vault?

Нет, Team Vault работает без API-ключей и переменных окружения.

Team Vault — hosted или self-hosted?

Доступен hosted-вариант: Unyly запускает сервер в облаке, локальная установка не обязательна.

Как установить Team Vault в Claude Desktop, Claude Code или Cursor?

Открой Team Vault на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.

Compare Team Vault with

Team VaultvsFetch Team VaultvsAWS KB Retrieval Team VaultvsSpring AI MCP Server Team Vaultvsllm-analysis-assistant

Не уверен что выбрать?

Найди свой стек за 60 секунд

Автор?

Embed-бейдж для README

Похожее

Все в категории ai

Command Palette