devvault-mcp

Небольшой MCP сервер, который предоставляет Claude Code структурированный доступ к локальной базе данных Postgres DevVault — просмотр схемы, выполнение запросов только для чтения, защищённые записи и заполнение тестовыми данными.

Подключение

DATABASE_URL определяется в следующем порядке:

1. process.env.DATABASE_URL

2. DEVVAULT_ENV_PATH (путь к файлу .env), если задан

3. ../devvault-backend/.env

Таким образом, пароль БД остаётся в .env бэкенда и не дублируется ни в какой конфигурации MCP.

Related MCP server: PostgreSQL MCP Server

Инструменты

Защитные механизмы

• run_query отклоняет всё, что не является только для чтения, и блокирует объединение операторов (;).

• run_write отклоняет DROP/TRUNCATE/ALTER/CREATE/GRANT/… и отклоняет UPDATE/DELETE без условия WHERE, если не передано allowDangerous: true.

• Записи выполняются в транзакции и откатываются при ошибке.

Регистрация в Claude Code

Уже настроено через ../.mcp.json (в рамках проекта):

{
  "mcpServers": {
    "devvault-db": {
      "command": "node",
      "args": ["/Users/cookie/project-git/devvault_2/devvault-mcp/server.js"]
    }
  }
}

MCP-серверы загружаются при запуске Claude Code, поэтому перезапустите / переподключите сессию, чтобы появились инструменты devvault-db.

Локальные проверки (без MCP-клиента)

npm install
node smoke.js     # connectivity + row counts
node mcptest.js   # full MCP handshake: list tools + call a few

Тестовые данные

Строки, созданные seed_dummy, имеют заголовки, начинающиеся с Dummy . Чтобы удалить их:

DELETE FROM prompts  WHERE title LIKE 'Dummy %';
DELETE FROM commands WHERE title LIKE 'Dummy %';
DELETE FROM snippets WHERE title LIKE 'Dummy %';
DELETE FROM bookmarks WHERE title LIKE 'Dummy %';
DELETE FROM notes    WHERE title LIKE 'Dummy %';