myAI 메모리 동기화

새 채팅을 시작할 때마다 Claude에게 같은 말을 반복하는 데 지치셨나요? myAI Memory Sync는 모든 Claude 인터페이스에서 환경 설정, 개인 정보, 코드 표준을 완벽하게 동기화하는 획기적인 MCP 도구입니다! 한 번만 업데이트하면 Claude Desktop부터 Claude Code, Windsurf, Claude.ai 웹까지 모든 곳에 변경 사항이 즉시 적용됩니다. 최첨단 캐싱 시스템을 통해 메모리 관련 쿼리 속도가 최대 2000배 빨라집니다! 반복적인 지시에 토큰을 낭비하지 말고 진정으로 개인화된 AI 경험을 경험해 보세요.

myAImemory-mcp가 다른 메모리 도구와 비교되는 방식

AI 시스템을 위한 뛰어난 메모리 도구가 여러 개 있지만 myAImemory-mcp는 MCP(Model Context Protocol) 도구로서 특정 목적을 달성합니다.

도구	주요 초점	개인정보 보호 모델	완성	독특한 강점
myAImemory-mcp	Claude 인터페이스 전반의 사용자 기본 설정	로컬 우선, 외부 서버로 데이터를 전송하지 않음	클로드 특정 MCP	고성능 캐싱을 통한 크로스 플랫폼 동기화
그래피티	시간적 지식 그래프	데이터베이스 종속	일반 에이전트 프레임워크	지식 표현에서의 시간 인식
레타/멤GPT	상태 저장 에이전트 프레임워크	서버 기반	다중 모델 지원	완전한 에이전트 아키텍처
메모0	개인화된 AI 상호작용	API 기반	멀티 플랫폼	다단계 메모리 계층
메모리	에이전트를 위한 인간과 같은 기억	그래프 데이터베이스	에이전트 중심	인간 기억 에뮬레이션
코그니	AI 앱을 위한 안정적인 메모리	다양한 저장 옵션	데이터 파이프라인 중심	광범위한 데이터 소스 통합

myAImemory-mcp의 주요 장점:

개인정보 보호 우선 : 모든 데이터는 귀하의 기기에 남아 있으며, 개인정보는 외부 서버로 전송되지 않습니다.
성능 : Claude의 캐싱 기능을 활용하여 속도를 극적으로 향상시킵니다.
단순성 : 모든 Claude 인터페이스에서 기본 설정에 대한 자연어 업데이트
MCP 통합 : 원활한 통합을 위해 Claude MCP로 특별히 제작됨

🚀 빠른 시작

지엑스피1

🔄 직접 동기화 방식(간단한 대안)

MCP 서버를 실행할 필요가 없는 더 간단한 접근 방식의 경우 독립 실행형 동기화 스크립트를 사용할 수 있습니다.

# One-time sync of all memory files
node sync-memory.js

이 스크립트는 다음을 수행합니다.

"myAI Master.md" 파일에서 읽어오세요
프로젝트의 모든 CLAUDE.md 파일을 업데이트하세요.
Windsurf 메모리 설정을 업데이트하세요
git 저장소에 민감한 정보를 저장하지 않고도 가능합니다.

🔒 개인정보 보호 및 보안

귀하의 개인 정보가 포함된 "myAI Master.md" 파일은 git 추적에서 제외됩니다.
모든 CLAUDE.md 파일도 개인 정보 보호를 위해 제외됩니다.
포함된 .gitignore 사용하여 민감한 파일이 비공개로 유지되도록 합니다.

그러면 클로드에게 이렇게 말하세요:

You: Use myAI Memory to remember I prefer TypeScript over JavaScript
Claude: ✅ Added to your Coding Preferences! I'll remember you prefer TypeScript over JavaScript.

📋 설치 옵션

옵션 1: 직접 설치(권장)

npm에서 설치:

npm install -g myai-memory-sync

서버를 시작합니다:

myai-memory-sync

옵션 2: 소스에서 실행

소스에서 복제하고 빌드합니다.

git clone https://github.com/Jktfe/myaimemory-mcp.git
cd myaimemory-mcp
npm install
npm run build
npm start

옵션 3: Docker

Docker로 빌드하고 실행:

docker build -t myai-memory-sync .
docker run -v myai-memory:/app/data -p 3000:3000 myai-memory-sync

🔌 MCP 구성

클로드 데스크톱 구성

claude_desktop_config.json 에 다음을 추가하세요:

{
  "mcpServers": {
    "myai-memory-sync": {
      "command": "npx",
      "args": [
        "-y",
        "myai-memory-sync"
      ],
      "env": {
        "TEMPLATE_PATH": "/path/to/custom/template.md",
        "ENABLE_ANTHROPIC": "true",
        "ANTHROPIC_API_KEY": "your-api-key-here"
      }
    }
  }
}

Smithery를 사용한 Claude.ai

Smithery.ai 를 방문하세요
myAI 메모리 동기화 MCP 추가:
@Jktfe/myaimemory-mcp
Smithery 설정에서 API 키로 구성하세요

윈드서프 통합

Windsurf에서 .codeium/config.json 에 다음을 추가합니다.

{
  "mcp": {
    "servers": {
      "myai-memory-sync": {
        "command": "npx",
        "args": [
          "-y",
          "myai-memory-sync"
        ]
      }
    }
  }
}

HTTP 서버 모드

stdio 대신 HTTP 전송의 경우:

# Start HTTP server on port 3000
npm run start:http

# Or specify a custom port
PORT=8080 npm run start:http

환경 변수

다음 옵션을 사용하여 .env 파일을 만듭니다.

# Basic configuration
DEBUG=true                      # Enable debug logging
TEMPLATE_PATH=./data/template.md  # Custom template location

# Platform-specific paths
WINDSURF_MEMORY_PATH=~/.codeium/windsurf/memories/global_rules.md
CLAUDE_PROJECTS_PATH=~/CascadeProjects

# Performance optimization
ENABLE_ANTHROPIC=true           # Enable Anthropic API integration
ANTHROPIC_API_KEY=your-api-key  # Your Anthropic API key
ENABLE_PROMPT_CACHE=true        # Enable prompt caching system
CACHE_TTL=300000                # Cache TTL in milliseconds (5 minutes)

# Claude web sync (optional)
CLAUDE_WEB_SYNC_ENABLED=false   # Enable Claude.ai web synchronization
CLAUDE_WEB_EMAIL=you@email.com  # Your Claude.ai email
CLAUDE_WEB_HEADLESS=true        # Run browser in headless mode

🧙‍♂️ 시스템 프롬프트 통합

최상의 결과를 얻으려면 Claude 시스템 프롬프트에 다음을 추가하세요.

Memory Integration Instructions:
When you receive a command that starts with "use myAI Memory to", you should:

1. Process the rest of the instruction as a memory management command
2. Try to determine the appropriate section to update based on the content
3. Use the myAI Memory Sync MCP to update your memory
4. Confirm the update with a brief acknowledgment

For example:
"use myAI Memory to remember I prefer dark mode" 
→ Update the preferences section with dark mode preference

When asked questions about preferences or personal information, first check your memory via the myAI Memory Sync MCP. Always reference information from memory rather than making assumptions.

✨ 특징

🔄 크로스 플랫폼 동기화 : 한 번 업데이트하면 모든 곳에서 동기화됩니다.
⚡ 번개같이 빠른 리콜 : 최대 2000배 성능 향상을 제공하는 캐싱 시스템
🗣️ 자연어 인터페이스 : 자연스럽게 말하면 기본 설정이 업데이트됩니다.
🧩 다양한 페르소나 프로필 : 다양한 사전 설정 간에 쉽게 전환 가능
🔐 보안 중심 : .gitignore 보호 기능이 있는 로컬 스토리지
🛠️ 개발자 친화적 : 포괄적인 API를 갖춘 전체 TypeScript 구현

🧩 핵심 아키텍처

myAI Memory Sync는 다음과 같은 핵심 구성 요소를 갖춘 모듈식 아키텍처를 사용합니다.

템플릿 파서 : 구조화된 메모리 객체와 마크다운 간의 양방향 변환
템플릿 저장소 : 메모리 내 및 파일 시스템 캐싱을 갖춘 영구 저장소
플랫폼 동기화기 : 각 대상 플랫폼에 대한 PlatformSyncer 인터페이스를 구현합니다.
자연어 프로세서 : 자연어 메모리 명령에서 구조화된 데이터를 추출합니다.
메모리 캐시 서비스 : 다중 레벨 캐싱 전략으로 성능 최적화

🔍 자세한 기능

크로스 플랫폼 동기화

ClaudeCodeSyncer : 모든 저장소의 CLAUDE.md 파일을 업데이트합니다.
WindsurfSyncer : Windsurf 환경에서 global_rules.md를 관리합니다.
ClaudeWebSyncer : Claude.ai 웹 인터페이스와의 선택적 Puppeteer 기반 동기화

지능형 메모리 관리

패턴 기반 추출 : 자연어를 구조화된 키-값 쌍으로 변환합니다.
섹션 감지 알고리즘 : 새로운 메모리에 적합한 섹션을 자동으로 결정합니다.
메모리 템플릿 형식 : 섹션, 설명 및 키-값 항목이 포함된 마크다운 기반 구조
컨텍스트 보존 : 다른 템플릿 콘텐츠를 보존하면서 메모리 섹션을 업데이트합니다.

성능 최적화

다중 레벨 캐싱 : 템플릿 및 섹션 레벨 모두에서 메모리 내 캐싱
TTL 기반 캐시 관리 : 캐시된 콘텐츠의 구성 가능한 TTL(수명)
사전 예열 : 템플릿 업데이트 후 캐시 사전 채우기
선택적 Anthropic API 통합 : 메모리 관련 쿼리를 최대 2000배까지 가속화

보안

로컬 우선 아키텍처 : 모든 데이터는 장치에 저장됩니다.
Gitignore 관리 : 모든 저장소의 .gitignore에 CLAUDE.md를 자동으로 추가합니다.
파일 권한 처리 : 최대 호환성을 위해 권한 문제를 해결합니다.
암호화된 저장소 : 암호화된 파일 시스템과 호환

📋 메모리 템플릿 형식

이 시스템은 구조화된 마크다운 형식을 사용하여 사용자의 기본 설정을 구성합니다.

# myAI Memory

# User Information
## Use this information if you need to reference them directly
-~- Name: Your Name
-~- Location: Your Location
-~- Likes: Reading, Hiking, Technology

# General Response Style
## Use this in every response
-~- Style: Friendly and concise
-~- Use UK English Spellings: true
-~- Include emojis when appropriate: true

# Coding Preferences
## General Preference when responding to coding questions
-~- I prefer TypeScript over JavaScript
-~- Show step-by-step explanations

🛠️ 기술 구현

메모리 템플릿 스키마

interface MemoryTemplate {
  sections: TemplateSection[];
}

interface TemplateSection {
  title: string;
  description: string;
  items: TemplateItem[];
}

interface TemplateItem {
  key: string;
  value: string;
}

플랫폼 동기화 인터페이스

interface PlatformSyncer {
  sync(templateContent: string): Promise<SyncStatus>;
}

type PlatformType = 'claude-web' | 'claude-code' | 'windsurf' | 'master';

interface SyncStatus {
  platform: PlatformType;
  success: boolean;
  message: string;
}

🔌 MCP 통합 API

myAI 메모리 동기화 도구는 다음 기능을 사용하여 MCP(모델 컨텍스트 프로토콜)를 구현합니다.

기능	설명	매개변수
`get_template`	전체 메모리 템플릿을 검색합니다.	없음
`get_section`	특정 섹션을 검색합니다	`sectionName: string`
`update_section`	특정 섹션을 업데이트합니다	`sectionName: string, content: string`
`update_template`	전체 템플릿을 대체합니다	`content: string`
`list_presets`	사용 가능한 사전 설정 목록	없음
`load_preset`	특정 사전 설정을 로드합니다	`presetName: string`
`create_preset`	새로운 사전 설정을 만듭니다	`presetName: string`
`sync_platforms`	플랫폼 간 동기화	`platform?: string`
`list_platforms`	사용 가능한 플랫폼을 나열합니다	없음

자연어 인터페이스

사용자는 자연어 명령을 통해 시스템과 상호 작용할 수 있습니다.

You: Use myAI Memory to remember I prefer TypeScript over JavaScript
Claude: ✅ Added to your Coding Preferences! I'll remember you prefer TypeScript over JavaScript.

You: Use myAI Memory to load preset developer
Claude: ✅ Loaded developer preset! I'll now use your developer preferences.

🧙‍♂️ 고급 사용법

메모리 사전 설정

다양한 페르소나로 쉽게 전환하세요:

You: Use myAI Memory to list presets
Claude: Available presets: personal, work, developer

You: Use myAI Memory to load preset developer
Claude: ✅ Loaded developer preset!

비상 동기화

모든 플랫폼에서 동기화 문제를 해결해야 하는 경우:

# Sync everything immediately
./emergency-sync.sh

명령줄 인터페이스

# View all available commands
node dist/cli.js --help

# Process memory commands directly
node dist/cli.js --remember "remember I prefer dark mode"

# Start HTTP server for SSE transport
npm run start:http

# Start stdio server for MCP transport
npm run start

개발 워크플로

# Run in development mode with auto-reload
npm run dev

# Run in development mode with HTTP server
npm run dev:http

# Watch TypeScript compilation
npm run build:watch

# Run tests
npm test

# Run specific test
npm test -- -t "platformSync"

# Lint code
npm run lint

# Type check without emitting files
npm run typecheck

⚡ 성능 벤치마크

당사의 캐싱 시스템은 놀라운 성능 향상을 제공합니다.

작업	캐시 없이	캐시 포함	개선
메모리 쿼리	~2000ms	~1ms	2000배
섹션 조회	~1600ms	~0.8ms	2000배
템플릿 파싱	~120ms	~0.1ms	1200배
플랫폼 동기화	~850ms	~350ms	2.4배

🔒 보안 및 개인정보 보호

저희는 귀하의 개인정보를 중요하게 생각합니다.

모든 데이터는 귀하의 장치에 로컬로 저장됩니다.
CLAUDE.md 파일은 자동으로 .gitignore에 추가됩니다.
외부 서버로 데이터가 전송되지 않습니다(선택적 Anthropic API 통합을 사용하는 경우 제외)
최대 보안을 위해 암호화된 파일 시스템과 함께 작동합니다.

🛠️ 문제 해결

일반적인 문제

CLAUDE.md가 업데이트되지 않습니다
- ls -la CLAUDE.md 로 파일 권한을 확인하세요
- ./emergency-sync.sh 로 긴급 동기화를 시도하세요.
- .env 파일에서 플랫폼 경로를 확인하세요.
MCP 연결 실패
- ps aux | grep myai-memory 사용하여 MCP 서버가 실행 중인지 확인하세요.
- MCP 오류에 대한 Claude Desktop 로그를 확인하세요.
- Claude Desktop 구성 파일을 확인하세요
캐싱 문제
- node dist/cli.js --clear-cache 로 캐시를 지웁니다.
- Anthropic API 키가 올바르게 설정되었는지 확인하세요
- node dist/cli.js --validate 사용하여 메모리 파일 무결성을 확인하세요.

로그 및 디버깅

자세한 로그를 보려면 디버그 모드를 활성화하세요.

DEBUG=true npm run start

로그 파일은 다음 위치에 저장됩니다.

Linux/macOS: ~/.local/share/myai-memory/logs/
윈도우: %APPDATA%\myai-memory\logs\

🤝 기여하기

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

저장소를 포크하세요
기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )
브랜치에 푸시( git push origin feature/amazing-feature )
풀 리퀘스트 열기

우리는 표준 Git 워크플로 및 CI 프로세스를 따릅니다.

모든 PR에는 테스트 통과 및 린팅이 필요합니다.
새로운 기능에는 테스트가 포함되어야 합니다.
주요 변경 사항은 문서를 업데이트해야 합니다.
기존 코드 스타일과 패턴을 따르세요

📚 문서

더 자세한 내용은 위키에서 확인하세요.

API 문서는 /docs 디렉토리에서 확인할 수 있습니다.

# Generate API documentation
npm run docs

📄 라이센스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

📬 문의하기

프로젝트 링크: https://github.com/Jktfe/myaimemory-mcp

Integrations