mcp-sqlite-graph-memory

AI 코딩 어시스턴트와 자율 에이전트를 위한 동적 SQLite 기반 코드 지식 그래프 메모리를 제공하는 범용 Model Context Protocol(MCP) 서버입니다.

활성 작업 공간을 자동으로 감지하고, 다중 언어 AST와 구조적 종속성을 격리된 로컬 SQLite 지식 그래프로 파싱하며, 심볼 검사, 최단 호출/가져오기 경로 계산, 코드 토폴로지 탐색을 위한 정밀한 MCP 도구를 제공합니다.

🌟 주요 기능

• 런타임 종속성 제로: 전적으로 Python 표준 라이브러리(ast, sqlite3, json, re, hashlib, threading)로 작성되었습니다.

• 동적 다중 작업 공간 격리: 작업 공간 루트별로 결정적 SHA-256 해시를 생성하고, 격리된 SQLite 데이터베이스를 ~/.mcp-graph-memory/storage/graph_<hash>.db에 저장합니다.

• 증분 stat 캐싱: 파일 mtime과 size를 검증하여 재인덱싱 중 변경되지 않은 파일은 1밀리초 미만으로 건너뜁니다.

• 다중 언어 AST 및 구조적 파서:

  • Python: 클래스, 메서드, 비동기 함수, 함수, 데코레이터, 가져오기(from x import y, import z), 상속 계층, 호출 지점.

  • TypeScript / JavaScript: 클래스, 인터페이스, 타입, 함수, 화살표 함수, ES6 가져오기/내보내기, CommonJS require().

  • Go: 패키지, 가져오기, 구조체, 인터페이스, 함수, 메서드.

  • Rust: 모듈, 구조체, 열거형, 트레이트, impl 블록, fn 시그니처.

  • C / C++ / Java / PHP / Ruby / Kotlin / Swift / Shell: 구조체, 클래스, 정의.

• 동결 및 CPU 기아 방지:

  • 비차단 비동기 데몬 초기화.

  • 비점유 stdio 전송(for raw_line in sys.stdin:).

  • node_modules/, .git/, .venv/, 바이너리 가중치, 캐시 블롭에 대한 엄격한 무시 목록.

🛠️ MCP 도구 사양

🚀 설치

git clone https://github.com/Luiguard/mcp-sqlite-graph-memory.git ~/.mcp-graph-memory
chmod +x ~/.mcp-graph-memory/server.py

🔌 통합 가이드

1. Google Antigravity 통합

옵션 A: 전역 구성(권장)

graph-memory를 ~/.gemini/config/mcp_config.json의 전역 Antigravity MCP 구성 파일에 추가하세요:

{
  "mcpServers": {
    "graph-memory": {
      "command": "python3",
      "args": [
        "/home/YOUR_USER/.mcp-graph-memory/server.py"
      ]
    }
  }
}

(/home/YOUR_USER를 실제 $HOME 디렉터리 경로로 바꾸거나 절대 경로를 사용하세요).

옵션 B: 작업 공간 수준 구성

프로젝트별 활성화를 위해 mcp_config.json을 작업 공간 루트의 .agents/mcp_config.json 아래에 배치하세요:

{
  "mcpServers": {
    "graph-memory": {
      "command": "python3",
      "args": [
        "${workspaceFolder}/.mcp-graph-memory/server.py"
      ]
    }
  }
}

2. Claude Desktop 통합

Claude 구성을 찾으세요:

• Linux: ~/.config/Claude/claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

서버 정의를 추가하세요:

{
  "mcpServers": {
    "graph-memory": {
      "command": "python3",
      "args": [
        "/path/to/mcp-sqlite-graph-memory/server.py"
      ]
    }
  }
}

3. Cursor / VSCode / Windsurf 통합

.cursor/mcp.json 또는 .vscode/mcp.json에서:

{
  "mcpServers": {
    "graph-memory": {
      "command": "python3",
      "args": [
        "/path/to/mcp-sqlite-graph-memory/server.py"
      ]
    }
  }
}

🔧 환경 변수

🧪 검증 및 테스트

자동화된 통합 테스트 스위트를 실행하세요:

python3 test_server.py

📄 라이선스

MIT 라이선스 - 저작권 (c) 2026 Benjamin Leimer. 자세한 내용은 LICENSE를 참조하세요.