Personal Memory MCP Server

Un servidor basado en TypeScript y SQLite que permite a la IA recordar datos personales para una comunicación personalizada.

GitHub
4
Prueba este MCPPatrocinado

Documentación

Personal Memory MCP Server

¿Cansado de que las conversaciones con IA comiencen desde cero cada vez? Este sistema permite que la IA realmente te recuerde y te entienda. Tu personalidad, preferencias, relaciones y experiencias importantes son recordadas naturalmente por la IA, permitiendo una comunicación profunda y personal como la de un amigo de toda la vida o una pareja en cada conversación. Ve más allá de simples preguntas y respuestas y crea una experiencia de IA genuina basada en relaciones y comprensión reales.

Características

  • Organización de datos basada en entidades (Persona, Empresa, Proyecto, etc.)
  • Seguimiento de observaciones con puntuación de importancia
  • Mapeo de relaciones entre entidades
  • Capacidades de búsqueda y resumen
  • Implementación en TypeScript con base de datos SQLite

Instalación

1. Instalar el MCP Server

# Clone repository
git clone https://github.com/moontmsai/my-memory-mcp.git
cd my-memory-mcp

# Install dependencies
npm install

# Build
npm run build

# Start server
npm start

2. Configurar Claude Desktop

Agrega esta configuración a tu archivo de configuración de Claude Desktop:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "my-memory": {
      "command": "node",
      "args": ["path/to/my-memory-mcp/dist/index.js"],
      "env": {
        "DATABASE_PATH": "path/to/my-memory-mcp/data/my-memory.sqlite"
      }
    }
  }
}

3. Configurar Cursor AI

Agrega esto a la configuración de Cursor AI:

  1. Abre la configuración de Cursor AI
  2. Ve a "Tools & Intergrations" → "MCP Tools"
  3. Agrega un nuevo servidor MCP:
{
  "mcpServers": {
    "my-memory": {
      "command": "node",
      "args": ["path/to/my-memory-mcp/dist/index.js"],
      "env": {
        "DATABASE_PATH": "path/to/my-memory-mcp/data/my-memory.sqlite"
      }
    }
  }
}

Nota: Reemplaza path/to/my-memory-mcp con la ruta real a tu directorio de instalación.

Desarrollo

# Development mode with auto-restart
npm run dev

# Type checking
npm run type-check

# Clean build
npm run clean

Herramientas de API

my-memory:create

Crea entidades, observaciones o relaciones.

Parámetros:

  • type: "entity" | "observation" | "relation"
  • entityType: Tipo de entidad (para entidades)
  • name: Nombre de la entidad (para entidades)
  • entityId: ID de entidad objetivo (para observaciones)
  • value: Contenido de la observación (para observaciones)
  • sourceEntityId: ID de entidad fuente (para relaciones)
  • targetEntityId: ID de entidad objetivo (para relaciones)
  • importanceScore: Puntuación de importancia (0-100)
  • notes: Notas adicionales
  • properties: Propiedades de la relación (objeto JSON)

my-memory:get

Recupera entidades, observaciones o relaciones.

Parámetros:

  • type: "entity" | "observation" | "relation"
  • entityType: Filtrar por tipo de entidad
  • entityId: Filtrar por entidad específica
  • sourceEntityId: Filtrar por entidad fuente (relaciones)
  • minImportance: Puntuación mínima de importancia
  • includeDetails: Incluir información detallada

my-memory:search

Busca y resume datos de memoria.

Parámetros:

  • mode: "summary" | "importance"
  • entityId: Entidad a resumir (modo resumen)
  • minScore: Puntuación mínima de importancia (modo importancia)
  • type: Filtrar por tipo de datos
  • includeDetails: Incluir información detallada

my-memory:update

Actualiza entidades, observaciones o relaciones existentes.

Parámetros:

  • type: "entity" | "observation" | "relation"
  • id: ID del elemento a actualizar
  • data: Campos de datos actualizados

my-memory:delete

Elimina entidades, observaciones o relaciones.

Parámetros:

  • type: "entity" | "observation" | "relation"
  • id: ID del elemento a eliminar
  • entityId: Eliminar todos los elementos de una entidad específica
  • cascade: Eliminar datos relacionados
  • minImportance: Importancia mínima para eliminar
  • maxImportance: Importancia máxima para eliminar

Estructura de Datos

Entidad

  • Representa personas, empresas, proyectos, conceptos, etc.
  • Tiene tipo, nombre y puntuación de importancia
  • Puede tener múltiples observaciones y relaciones

Observación

  • Información específica sobre una entidad
  • Incluye tipo, valor, puntuación de importancia y notas
  • Con marca de tiempo para seguimiento de cambios

Relación

  • Conexión entre dos entidades
  • Tiene tipo y propiedades opcionales
  • Soporta modelado de relaciones complejas

Ejemplos de Uso

// Create a person entity
my-memory:create({
  type: "entity",
  entityType: "Person", 
  name: "John Doe",
  importanceScore: 80
})

// Add observation about the person
my-memory:create({
  type: "observation",
  entityId: "entity_id",
  value: "Prefers direct communication",
  importanceScore: 85,
  notes: "Important for work interactions"
})

// Create relationship
my-memory:create({
  type: "relation",
  sourceEntityId: "person_id",
  targetEntityId: "company_id", 
  properties: { role: "developer", startDate: "2025-01-01" }
})

// Search by importance
my-memory:search({
  mode: "importance",
  minScore: 80,
  includeDetails: true
})

// Get entity summary
my-memory:search({
  mode: "summary",
  entityId: "entity_id"
})

Preferencias de Usuario Recomendadas

Para un uso óptimo con asistentes de IA, agrega esta configuración a tus preferencias de usuario:

0. Session initialization (execute only once at session start):
   - Query relationships with importance score 80+ using includeDetails=true from my-memory MCP
   - Additionally query observations with importance score 80+ for relevant entities
   - Do not brief the retrieved personal memories

1. Continuous operation during conversations:
   - Record new personal information in my-memory MCP when discovered
   - Judge importance score (0-100 points) for all responses
   - Base judgments only on existing memories without repeated queries

2. Personal information collection (personal information only):
   - Basic identity (age, gender, location, occupation, education, health status, etc.)
   - Behavioral patterns (interests, habits, hobbies, personality traits, etc.)
   - Preferences (communication style, preferred language, style, values, etc.)
   - Long-term goals (life goals, long-term plans, personal aspirations, etc.)
   - Relationships (family, friends, romantic partners, colleagues, etc.)

3. my-memory MCP memory updates:
   - Entity creation (with importance scores): Important people, organizations, places, concepts
   - Relationship connections: Establish relations with existing entities
   - Observation storage: Record personal characteristics and facts as observations

4. What NOT to record in my-memory MCP:
   - Specific work details (coding specifics, particular task progress, etc.)
   - Temporary work memory (today's tasks, temporary notes, etc.)
   - Technical details (configuration values, code snippets, error messages, etc.)

5. Additional operational principles for my-memory MCP:
   - Set importance scores based on personal significance and long-term relevance
   - Record relationship information with high importance
   - Carefully record personal tendencies and values
   - Record work-related information only at company name, position, colleague name level

Licencia

Licencia MIT

☕ Apoya Mi Trabajo

Si encuentras este proyecto útil o interesante, ¡considera invitarme un café!
Tu apoyo me ayuda a mantener y mejorar este trabajo de código abierto.

Buy Me A Coffee

개인 기억 MCP 서버

AI와의 대화가 매번 처음부터 다시 시작되는 것이 아쉬우셨나요? 이 시스템은 AI가 당신을 진짜로 기억하고 이해할 수 있게 해줍니다. 당신의 성격, 취향, 인간관계, 중요한 경험들을 AI가 자연스럽게 기억하며, 대화할 때마다 마치 오랜 친구나 연인처럼 깊이 있고 개인적인 소통이 가능해집니다. 단순한 질답을 넘어서, 진정한 관계와 이해를 바탕으로 한 AI 경험을 만들어보세요.

주요 기능

  • 엔티티 기반 데이터 구조 (사람, 회사, 프로젝트 등)
  • 중요도 점수를 통한 관찰 추적
  • 엔티티 간 관계 매핑
  • 검색 및 요약 기능
  • TypeScript 구현 및 SQLite 데이터베이스

설치

1. MCP 서버 설치

# 저장소 복제
git clone https://github.com/moontmsai/my-memory-mcp.git
cd my-memory-mcp

# 의존성 설치
npm install

# 빌드
npm run build

# 서버 시작
npm start

2. Claude Desktop 설정

Claude Desktop 설정 파일에 다음 구성을 추가하세요:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "my-memory": {
      "command": "node",
      "args": ["path/to/my-memory-mcp/dist/index.js"],
      "env": {
        "DATABASE_PATH": "path/to/my-memory-mcp/data/my-memory.sqlite"
      }
    }
  }
}

3. Cursor AI 설정

Cursor AI 설정에 다음을 추가하세요:

  1. Cursor AI 설정 열기
  2. Go to "Tools & Intergrations" → "MCP Tools"
  3. Add new MCP server:
{
  "mcpServers": {
    "my-memory": {
      "command": "node",
      "args": ["path/to/my-memory-mcp/dist/index.js"],
      "env": {
        "DATABASE_PATH": "path/to/my-memory-mcp/data/my-memory.sqlite"
      }
    }
  }
}

참고: path/to/my-memory-mcp를 실제 설치 디렉토리 경로로 변경하세요.

개발

# 개발 모드 (자동 재시작)
npm run dev

# 타입 체크
npm run type-check

# 빌드 정리
npm run clean

API 도구

my-memory:create

엔티티, 관찰, 관계를 생성합니다.

매개변수:

  • type: "entity" | "observation" | "relation"
  • entityType: 엔티티 유형 (엔티티용)
  • name: 엔티티 이름 (엔티티용)
  • entityId: 대상 엔티티 ID (관찰용)
  • value: 관찰 내용 (관찰용)
  • sourceEntityId: 소스 엔티티 ID (관계용)
  • targetEntityId: 타겟 엔티티 ID (관계용)
  • importanceScore: 중요도 점수 (0-100)
  • notes: 추가 메모
  • properties: 관계 속성 (JSON 객체)

my-memory:get

엔티티, 관찰, 관계를 조회합니다.

매개변수:

  • type: "entity" | "observation" | "relation"
  • entityType: 엔티티 유형별 필터
  • entityId: 특정 엔티티별 필터
  • sourceEntityId: 소스 엔티티별 필터 (관계용)
  • minImportance: 최소 중요도 점수
  • includeDetails: 상세 정보 포함

my-memory:search

메모리 데이터를 검색하고 요약합니다.

매개변수:

  • mode: "summary" | "importance"
  • entityId: 요약할 엔티티 (요약 모드)
  • minScore: 최소 중요도 점수 (중요도 모드)
  • type: 데이터 유형별 필터
  • includeDetails: 상세 정보 포함

my-memory:update

기존 엔티티, 관찰, 관계를 수정합니다.

매개변수:

  • type: "entity" | "observation" | "relation"
  • id: 수정할 항목 ID
  • data: 수정할 데이터 필드

my-memory:delete

엔티티, 관찰, 관계를 삭제합니다.

매개변수:

  • type: "entity" | "observation" | "relation"
  • id: 삭제할 항목 ID
  • entityId: 특정 엔티티의 모든 항목 삭제
  • cascade: 관련 데이터 함께 삭제
  • minImportance: 삭제할 최소 중요도
  • maxImportance: 삭제할 최대 중요도

데이터 구조

엔티티

  • 사람, 회사, 프로젝트, 개념 등을 나타냄
  • 유형, 이름, 중요도 점수를 가짐
  • 여러 관찰과 관계를 가질 수 있음

관찰

  • 엔티티에 대한 구체적 정보
  • 유형, 내용, 중요도 점수, 메모 포함
  • 변경 추적을 위한 타임스탬프

관계

  • 두 엔티티 간의 연결
  • 유형과 선택적 속성을 가짐
  • 복잡한 관계 모델링 지원

사용 예시

// 사람 엔티티 생성
my-memory:create({
  type: "entity",
  entityType: "Person", 
  name: "홍길동",
  importanceScore: 80
})

// 사람에 대한 관찰 추가
my-memory:create({
  type: "observation",
  entityId: "entity_id",
  value: "직설적인 소통을 선호함",
  importanceScore: 85,
  notes: "업무 상호작용에 중요"
})

// 관계 생성
my-memory:create({
  type: "relation",
  sourceEntityId: "person_id",
  targetEntityId: "company_id", 
  properties: { role: "개발자", startDate: "2025-01-01" }
})

// 중요도별 검색
my-memory:search({
  mode: "importance",
  minScore: 80,
  includeDetails: true
})

// 엔티티 요약
my-memory:search({
  mode: "summary",
  entityId: "entity_id"
})

권장 사용자 설정

AI 어시스턴트와 최적으로 사용하려면 사용자 설정에 다음 구성을 추가하세요:

0. 세션 초기화 (세션 시작 시 1회만 실행):
   - my-memory MCP에서 중요도 80점 이상의 관계를 includeDetails=true로 조회
   - 추가로 해당 엔티티의 중요도 80점 이상의 관찰도 함께 조회
   - 조회한 개인적인 기억은 브리핑하지 않음

1. 대화 중 지속적 운영:
   - 새로운 개인 정보 발견 시 my-memory MCP에 기록
   - 모든 응답에 대해 중요도 점수(0-100점) 판단
   - 기존 기억만을 기반으로 판단하고 반복 조회하지 않음

2. 개인 정보 수집 (개인적 정보만):
   - 기본 정체성 (나이, 성별, 위치, 직업, 학력, 건강상태 등)
   - 행동 패턴 (관심사, 습관, 취미, 성격 특성 등)
   - 선호도 (소통 방식, 선호 언어, 스타일, 가치관 등)
   - 장기적 목표 (인생 목표, 장기 계획, 개인적 열망 등)
   - 관계 (가족, 친구, 연인, 회사 동료 등)

3. my-memory MCP 기억 업데이트:
   - 엔티티 생성 (중요도 점수 부여): 중요한 사람, 조직, 장소, 개념
   - 관계 연결: 기존 엔티티들과 관계 설정
   - 관찰 저장: 개인적 특성과 사실들을 관찰로 기록

4. my-memory MCP에 기록하지 않는 것들:
   - 구체적인 작업 내용 (코딩 세부사항, 특정 업무 진행상황 등)
   - 일시적인 작업 기억 (오늘 해야 할 일, 임시 메모 등)
   - 기술적 세부사항 (설정값, 코드 조각, 에러 메시지 등)

5. my-memory MCP 추가 운용 원칙:
   - 중요도 점수는 개인적 중요성과 장기적 관련성을 기준으로 설정
   - 사람과의 관계 정보는 높은 중요도로 기록
   - 개인적 성향이나 가치관은 신중하게 기록
   - 작업 관련 정보는 회사명, 직책, 동료 이름 수준만 기록

라이선스

MIT 라이선스

☕ 후원하기

이 프로젝트가 도움이 되셨다면, 커피 한 잔으로 응원해주세요: https://coff.ee/moontmsai
여러분의 후원이 지속적인 오픈소스 개발에 큰 힘이 됩니다.