Promem-MCP

Project Memory MCP — AI 코딩 에이전트를 위한 지속적 프로젝트 컨텍스트. DIP-RO 제작.

pip install promem-mcp

데이터베이스 없음. 클라우드 없음. 데몬 없음. 수동 메모리 관리 없음.

ContextMCP는 로컬 우선, MCP 네이티브 컨텍스트 런타임으로, AI 코딩 에이전트에게 반복 설명이나 컨텍스트 낭비 없이 지속적인 프로젝트 이해 — 아키텍처, 규칙, 결정, 관례, 환경 인텔리전스, Git 컨텍스트 —를 제공합니다.

빠른 시작

pip install promem-mcp

그런 다음 ContextMCP를 AI 코딩 클라이언트에 등록하세요:

# See which clients are detected
promem config

# Auto-configure a specific client (with backup + merge)
promem config cursor
promem config claude-code
promem config claude-desktop
promem config vscode

또는 클라이언트의 MCP 설정에 수동으로 추가하세요:

{
  "mcpServers": {
    "contextmcp": {
      "command": "contextmcp",
      "args": []
    }
  }
}

VS Code 참고: VS Code는 "servers" 키를 사용하며 "mcpServers"가 아닙니다. 올바른 형식은 promem config vscode를 실행하세요.

이것으로 끝입니다. 이제 AI 코딩 에이전트에 지속적인 프로젝트 컨텍스트가 생겼습니다.

작동 방식

기능

• 제로 설정 스토리지 — SQLite 데이터베이스가 OS에 적합한 디렉터리에 자동 생성됩니다.

• 자동 프로젝트 감지 — 언어, 프레임워크, 패키지 매니저, 테스트 프레임워크

• 지속적 메모리 — 규칙, 결정, 관례, 환경 사실, Git 인텔리전스

• 토큰 효율적 검색 — 토큰 예산에 따른 FTS5 검색, 관련 컨텍스트만 반환

• 출처 추적 — 모든 메모리는 어디서 왔는지와 신뢰도를 알고 있습니다.

• 비밀 정보 편집 — API 키, 토큰, 비밀번호는 절대 저장되거나 반환되지 않습니다.

• 프로젝트 격리 — 프로젝트 메모리가 다른 프로젝트로 새지 않습니다.

• 오래된 컨텍스트 감지 — 현재 프로젝트 상태와 충돌하는 메모리를 표시합니다.

• 모순 감지 — 충돌하는 프로젝트 규칙을 식별합니다.

• 세션 연속성 — 에이전트/세션 간 전환을 위한 핸드오프 요약

• Git 인텔리전스 — 최근 커밋, 변경된 파일, TODOs/FIXMEs

• 환경 진단 — Python 버전, venv, .env 완전성, Docker

• 로컬 우선 — 네트워크 요청 없음, 클라우드 없음, 외부 서비스 없음

MCP 도구

CLI

contextmcp --version        # Version
promem status           # Project + storage status
promem doctor           # Health checks
promem stats            # Usage statistics
promem search "query"   # Search context
promem memory list      # List memories
promem decision "text"  # Save a decision
promem privacy          # Privacy info
promem config           # Client configuration
promem repair           # Rebuild index, optimize DB
promem reset            # Delete all data (with confirmation)

클라이언트 지원

어떤 클라이언트도 진정한 제로 구성 자동 등록을 지원하지 않습니다. ContextMCP는 설치된 클라이언트를 감지하고, 설정 작성(백업 및 병합 포함)을 제안하며, 정확한 복사-붙여넣기 스니펫을 제공합니다.

프라이버시

• 로컬 전용 — 네트워크 요청 없음

• 프로젝트 콘텐츠 업로드 안 함

• 비밀 정보 편집 — 저장되거나 반환되지 않음

• 클라우드 의존성 없음

promem privacy

저장 위치

ContextMCP는 프로젝트 로컬 스토리지를 사용합니다 — 중앙 집중식 OS 디렉터리 없음, 낭비되는 공간 없음.

각 프로젝트는 자체 .contextmcp/contextmcp.db를 갖습니다. 저장소는 프로젝트와 함께 이동합니다. 전역 저장소 비대화가 없습니다.

.contextmcp/를 .gitignore에 추가하세요 (ContextMCP의 무시 패턴에 기본적으로 이미 포함되어 있습니다).

필요한 경우 CONTEXTMCP_DATA_DIR 환경 변수로 재정의하세요.

설치

# pip
pip install promem-mcp

# uv
uv add contextmcp

# pipx (global CLI)
pipx install contextmcp

venv, virtualenv, uv, pipx, 시스템 Python에서 작동합니다.

개발

git clone https://github.com/contextmcp/contextmcp.git
cd contextmcp
pip install -e ".[dev]"
pytest

라이선스

MIT