devvault-mcp

一个轻量级 MCP 服务器，为 Claude Code 提供对 DevVault 本地 Postgres 数据库的结构化访问——检查 schema、运行只读查询、执行受保护的写入，以及为测试填充模拟数据。

连接

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/…，并拒绝没有 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 %';