英語

アンカーマインド

이게 뭔데 |어떻게 돌아가는데 |어떻게 설치하는데 |자주 묻는 질문

이게 뭔데

AI 에이전트(Claude Code, Cursor, Codex 등)にセッションが終わり난 뒤에도 남는 장기 기억を붙여 주는 MCP 서버다.직접 호스팅하며, 기억はPostgreSQLに저장한다.

에이전트는 세션이 끝나면 앞선 대화를 잊는다.짧게 말해, 다시 설명해야 한다.プロジェクト設定、어제 해결한 버그, 선호하는 작업 방식のように매번 반복하기 번거로운 내용을 AnchorMind가 short 단위(파편)로 저장해 두고, 다음 세션에서 필요한 것만 꺼내 준다.

이런 경우에 쓴다

• AI 에이전트를 매일 쓰는데 세션마다 같은 설명을 반복한다.
• Claude Code, Cursor, Codex など複数のエージェントと複数の기기で同じ記憶を共有하고 싶다。
• 프로젝트나 고객별로 기억을 나눠 두고 싶다.
• 기억을 내 서버와 내 데이터베이스에 보관하고 싶다.

어떻게 돌아가는데

1. AnchorMind サーバーを実行している。
2. エージェントにMCP 서버で登録している。
3. 세션이 시작되면 에이전트가 서버에서 핵심 기억을 받아 온다.대화 중에는 필요할 때 기억을 찾고, 남겨 둘 내용은 저장한다.
4. 에이전트는 그 기억을 참고해 답한다.

사용자 눈에는 대략 이렇게 보인다.

세션이 바뀔 때마다 같은 설명을 반복하지 않아도 된다.전체 흐름은 아래 다이어그램과 같다.

도구 호출은 에이전트가 맡는다.서버가 먼저 말을 걸지는 않는다.에이전트가 빠뜨리지 않고 호출하게 하려면 훅이나 지침 파일을 설정해야 한다(자동으로 쓰게 하려면).

어떻게 설치하는데

서버 설치

必要なもの: Node.js 22+, Docker.pgvectorが設置されたPostgreSQL이 이미 있다면 Dockerは없어も된다。

1.데이터베이스 (이미 있으면 건너뛴다)

2.서버

.envを열고 두 가지만 바꾼다.

• MEMENTO_ACCESS_KEYをchange-meが아닌 値でバ꾼다。이 값은 마스터 키이며, Authorization: Bearer 토큰으로 쓰인다.
• 아래 세 줄을 추가한다.外部API キー 없이 自然어 검색を쓰기 ためのローカル임베딩 설정이다。

DB 設定は위 docker run 값と맞아 있으므로 彼대로 두면 된다。

English

AnchorMind

이게 뭔데 | 어떻게 돌아가는데 | 어떻게 설치하는데 | 자주 묻는 질문

이게 뭔데

AI 에이전트(Claude Code, Cursor, Codex 등)에 세션이 끝난 뒤에도 남는 장기 기억을 붙여 주는 MCP 서버다. 직접 호스팅하며, 기억은 PostgreSQL에 저장한다.

에이전트는 세션이 끝나면 앞선 대화를 잊는다. 짧게 말해, 다시 설명해야 한다. 프로젝트 설정, 어제 해결한 버그, 선호하는 작업 방식처럼 매번 반복하기 번거로운 내용을 AnchorMind가 짧은 단위(파편)로 저장해 두고, 다음 세션에서 필요한 것만 꺼내 준다.

이런 경우에 쓴다

• AI 에이전트를 매일 쓰는데 세션마다 같은 설명을 반복한다.
• Claude Code, Cursor, Codex 등 여러 에이전트와 여러 기기에서 같은 기억을 공유하고 싶다.
• 프로젝트나 고객별로 기억을 나눠 두고 싶다.
• 기억을 내 서버와 내 데이터베이스에 보관하고 싶다.

어떻게 돌아가는데

1. AnchorMind 서버를 실행한다.
2. 에이전트에 MCP 서버로 등록한다.
3. 세션이 시작되면 에이전트가 서버에서 핵심 기억을 받아 온다. 대화 중에는 필요할 때 기억을 찾고, 남겨 둘 내용은 저장한다.
4. 에이전트는 그 기억을 참고해 답한다.

사용자 눈에는 대략 이렇게 보인다.

[세션 1]
사용자: 우리 프로젝트는 PostgreSQL 15를 쓰고 테스트는 Vitest로 돌려.
에이전트: (remember 호출, 파편 2개 저장)

[다음 날, 새 세션]
에이전트: (시작하며 context 호출, 저장해 둔 파편 2개를 받음)
사용자: 테스트 어떻게 돌리더라?
에이전트: (recall 호출) 이 프로젝트는 Vitest를 쓴다. npx vitest로 실행하면 된다.

세션이 바뀔 때마다 같은 설명을 반복하지 않아도 된다. 전체 흐름은 아래 다이어그램과 같다.

sequenceDiagram
    participant U as 사용자
    participant A as 에이전트
    participant M as AnchorMind 서버
    participant D as PostgreSQL

    U->>A: 세션 시작
    A->>M: context
    M->>D: 선호, 에러, 절차, 결정 조회
    M-->>A: 핵심 기억
    U->>A: 질문
    A->>M: recall
    M-->>A: 관련 기억
    A-->>U: 기억을 참고한 답변
    A->>M: remember (새 결정, 해결한 에러)
    U->>A: 세션 종료
    A->>M: reflect (세션 요약)

도구 호출은 에이전트가 맡는다. 서버가 먼저 말을 걸지는 않는다. 에이전트가 빠뜨리지 않고 호출하게 하려면 훅이나 지침 파일을 설정해야 한다(자동으로 쓰게 하려면).

어떻게 설치하는데

서버 설치

필요한 것: Node.js 22+, Docker. pgvector가 설치된 PostgreSQL이 이미 있다면 Docker는 없어도 된다.

1. 데이터베이스 (이미 있으면 건너뛴다)

docker run -d --name anchormind-db -p 5432:5432 \
  -e POSTGRES_PASSWORD=change-me -e POSTGRES_DB=memento \
  -v anchormind-pgdata:/var/lib/postgresql/data pgvector/pgvector:pg15

docker exec anchormind-db psql -U postgres -d memento \
  -c "CREATE EXTENSION IF NOT EXISTS vector"

2. 서버

git clone https://github.com/JinHo-von-Choi/anchormind.git
cd anchormind
npm install

cp .env.example.minimal .env