SQLite, 시맨틱 검색, 연결된 엔티티를 사용하여 코딩 에이전트가 세션 전반에 걸쳐 프로젝트 컨텍스트를 유지할 수 있도록 공유 로컬 메모리를 제공합니다.
다른 이름 sonic182/graphmem, @sonic182/graphmem
- 스타
- 9
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 0.15.2
- 마지막 커밋
- 2026년 11월 8일
- 라이선스
- MIT
Graphmem MCP란?
SQLite, 시맨틱 검색, 연결된 엔티티를 사용하여 코딩 에이전트가 세션 전반에 걸쳐 프로젝트 컨텍스트를 유지할 수 있도록 공유 로컬 메모리를 제공합니다.
프로젝트 README에서 생성된 요약
Graphmem MCP server 정보
Graphmem은 코딩 에이전트가 서로 다른 세션과 도구 사이에서 프로젝트 컨텍스트를 유지할 수 있도록 설계된 공유 로컬 메모리 시스템입니다. SQLite 저장소와 로컬 시맨틱 검색을 사용하여 연결된 엔티티를 저장하며, Claude Code, Codex, OpenCode, pi와 같은 여러 MCP 클라이언트가 동일한 데이터 저장소에 접근할 수 있도록 합니다. 이러한 설정을 통해 코딩 세션 중에 내린 결정이 지속적으로 유지되고 나중에 다시 활용될 수 있습니다.
사용자는 npm을 통해 서버를 설치하거나 플랫폼별 바이너리를 다운로드하여 설치할 수 있습니다. 시스템은 메모리 범위를 현재 Git 리포지토리로 기본 설정하지만, 글로벌 범위도 지원합니다. 개발자는 CLI 또는 MCP 도구를 통해 메모리를 관리할 수 있습니다. GRAPHMEM_HOME 환경 변수를 수정하지 않는 한, 서버는 모든 데이터를 ~/.graphmem 디렉토리에 저장합니다.
메모리 관리 외에도 서버에는 선택 사항인 코드 탐색 도구가 포함되어 있습니다. 이 도구들을 사용하면 에이전트가 심볼 정의를 찾고, 파일 import 목록을 조회하며, 코드 개요를 생성하고, 서로 다른 Git 리비전 간의 심볼을 비교할 수 있습니다. 이러한 특정 코드 기능은 임베딩 모델 없이도 Git 체크아웃 상태에서 작동합니다.
활용 사례
- 1프로젝트 결정 사항 유지에이전트에게 특정 코딩 컨벤션을 저장하도록 지시하여 향후 세션에서도 이를 기억하게 합니다.
- 2과거 컨텍스트 검색로컬 메모리에 저장된 특정 정보나 이전 지침을 AI가 찾도록 요청합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Graphmem MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Graphmem MCP 설치
$ claude mcp add graphmem -- npx -y @sonic182/graphmemCursor에 Graphmem MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"graphmem": {
"command": "npx",
"args": [
"-y",
"@sonic182/graphmem"
]
}
}
}VS Code에 Graphmem MCP 설치
.vscode/mcp.json
{
"servers": {
"graphmem": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sonic182/graphmem"
]
}
}
}VS Code CLI에 Graphmem MCP 설치
$ code --add-mcp '{"name":"graphmem","type":"stdio","command":"npx","args":["-y","@sonic182/graphmem"]}'Claude Desktop에 Graphmem MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"graphmem": {
"command": "npx",
"args": [
"-y",
"@sonic182/graphmem"
]
}
}
}Codex에 Graphmem MCP 설치
$ codex mcp add graphmem -- npx -y @sonic182/graphmemCodex config.toml에 Graphmem MCP 설치
~/.codex/config.toml
[mcp_servers.graphmem] command = "npx" args = ["-y", "@sonic182/graphmem"]
Gemini CLI에 Graphmem MCP 설치
$ gemini mcp add -s user graphmem npx -- -y @sonic182/graphmemGemini settings.json에 Graphmem MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"graphmem": {
"command": "npx",
"args": [
"-y",
"@sonic182/graphmem"
]
}
}
}자동 검사
2026년 11월 13일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능sonic182/graphmem is public and reachablegithub.com/sonic182/graphmem ↗통과
- 패키지가 이 저장소를 소스로 명시@sonic182/graphmem names sonic182/graphmem as sourcenpmjs.com/package/@sonic182/graphmem ↗통과
- 빌드 출처(Sigstore 증명)No build attestation published for this release검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-09github.com/sonic182/graphmem ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from @sonic182/graphmem통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음1 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기Graphmem

Shared, local memory for coding agents. Keep project decisions across sessions and tools with SQLite storage, local semantic search, and linked entities. Claude Code, Codex, OpenCode, pi, and other MCP clients can share the same store.
Optional code tools find definitions, outline files, list imports, and compare symbols between Git revisions.
Install
npm install --global @sonic182/graphmem
gmem-install
gmem version
The npm package contains launchers. gmem-install explicitly downloads and
verifies the matching CPU binary, or reuses a working native gmem on your
PATH. Package installation itself downloads no binary. After upgrading the
package, run gmem-install again; separately installed binaries are not replaced.
MCP clients that launch servers with npx can run npx -y @sonic182/graphmem mcp.
The graphmem command downloads and verifies the binary on its first run; gmem
never downloads anything on its own.
Alternatively, download your platform's archive from
GitHub Releases, verify
it against SHA256SUMS, and put the extracted executable on your PATH.
Linux releases require glibc 2.39 and OpenSSL 3. For other systems or CUDA,
build from source.
Use it with your coding agent
Plugins include MCP registration, skills, and guidance to recall context before work and save durable decisions afterward.
| Agent | Install |
|---|---|
| Claude Code | claude plugin marketplace add sonic182/graphmem, then claude plugin install graphmem@graphmem |
| Codex | codex plugin marketplace add sonic182/graphmem, then codex plugin add graphmem@graphmem |
| OpenCode | opencode plugin @sonic182/graphmem --global |
| pi | pi install npm:@sonic182/graphmem |
Claude Code and Codex need gmem and Node.js on PATH. In Codex, trust the
Graphmem hooks in /hooks and start a new thread. Pi offers binary setup on first
startup; OpenCode prints an installer command if needed.
See plugin setup and troubleshooting.
For another MCP client, configure it to launch your installed binary:
{
"mcpServers": {
"graphmem": {
"command": "/absolute/path/to/gmem",
"args": ["mcp"]
}
}
}
CLI
gmem remember "Use nextest for integration tests" \
--type convention --scope repo:/absolute/path/to/project
gmem search "integration tests"
gmem tokens --over-limit # memories the embedding model truncates
gmem tui
gmem mcp
Memories default to the current Git repository; git must be on PATH.
Outside a repository, the default scope is global. Reads always include global
memories; explicitly select other projects with --scope (CLI) or scopes (MCP).
Writes are limited to the current repository and global, including updates and
deletions. The MCP list_scopes tool discovers scopes and their write permissions;
list pages through the memories of a selection.
Data lives in ~/.graphmem; set GRAPHMEM_HOME to use another directory.
CLI reference · MCP tool reference
Code navigation (optional)
Release binaries include these tools; source builds need --features code.
| MCP tool | Purpose |
|---|---|
find_symbol |
Find a definition and its source range |
code_outline |
List a file's definitions and nesting |
code_imports |
List declared imports |
code_diff |
Compare symbols between Git revisions |
gmem code find CodeService
gmem code outline src/application/code.rs
gmem code imports src/application/code.rs
gmem code diff origin/master
These tools work on Git checkouts without an embedding model. They index
definitions, not call sites or references; use ast-grep for those.
Set GRAPHMEM_CODE=off to disable code tools.
Options and supported languages · Benchmark results and limitations
Configuration
No config file is required. To customize embeddings, retrieval, or code indexing,
create ~/.graphmem/config.toml. See the configuration reference.
Build
See source builds and CUDA setup.
Development
just verify
Runs formatting checks, compilation, Clippy, and tests. Design · Schema evolution
To preview the documentation site, run hugo server --source site.
See site setup.
License
MIT.
Graphmem MCP 질문
Graphmem MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add graphmem -- npx -y @sonic182/graphmem를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Graphmem MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
MCP 클라이언트에서 Graphmem을 사용하려면 어떻게 설치해야 하나요?
npm install --global @sonic182/graphmem 명령어로 npm을 통해 설치한 후 gmem-install을 실행하거나, npx를 지원하는 클라이언트의 경우 npx -y @sonic182/graphmem mcp를 사용하여 설치할 수 있습니다.
메모리 데이터는 어디에 저장되나요?
데이터는 ~/.graphmem 디렉토리에 로컬로 저장됩니다. 단, GRAPHMEM_HOME 환경 변수를 설정하여 저장 위치를 변경할 수 있습니다.
Graphmem으로 코드를 탐색할 수 있나요?
네, 선택 사항인 코드 도구를 통해 심볼 정의 찾기, 파일 개요 확인, import 목록 조회, Git 리비전 간 심볼 비교가 가능합니다.
Graphmem은 설정 파일이 필요한가요?
기본적으로 설정 파일은 필요하지 않지만, ~/.graphmem/config.toml 파일을 생성하여 임베딩, 검색 또는 코드 인덱싱 설정을 사용자 정의할 수 있습니다.