devvault-mcp

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 %';