devvault-mcp

Claude Code に DevVault のローカル Postgres データベースへの構造化されたアクセスを提供する小さな MCP サーバーです。スキーマの確認、読み取り専用クエリの実行、保護された書き込み、テスト用のダミーデータの投入ができます。

接続

DATABASE_URL は次の順序で解決されます：

1. process.env.DATABASE_URL

2. DEVVAULT_ENV_PATH（.env ファイルへのパス）が設定されている場合

3. ../devvault-backend/.env

したがって、DB パスワードはバックエンドの .env に保持され、どの MCP 設定にも複製されません。

Related MCP server: PostgreSQL MCP Server

ツール

安全ガード

• run_query は読み取り専用でないものを拒否し、ステートメントの連結（;）をブロックします。

• run_write は DROP/TRUNCATE/ALTER/CREATE/GRANT/… を拒否し、WHERE 句のない UPDATE/DELETE も拒否します。ただし 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 %';