Integrations
커서10x 메모리 시스템
MCP(Model Context Protocol)를 사용하는 Cursor를 위한 포괄적인 메모리 시스템입니다.
🚀 CURSOR10X 시스템 발표 🚀
AI 기반 자율 시스템으로 개발 프로세스를 혁신하세요
🔥 Cursor10x 메모리 시스템이 이제 완전한 Cursor10x 플랫폼의 일부가 되었습니다! 🔥
GitHub 에서 다음과 같은 완전한 자율 개발 생태계를 확인해 보세요.
- 📋 작업 관리 시스템 - 단계별 작업으로 안내되는 구현
- 🔄 자율 메모리 - 프로젝트 전체를 기억하는 상황 인식 AI
- 📊 프로젝트 청사진 - 귀하의 사양에 맞게 생성된 완전한 기술 아키텍처
- 📁 파일/폴더 아키텍처 - 모범 사례를 적용한 최적화된 프로젝트 구조
- 📘 구현 가이드 - 모든 파일 및 구성 요소에 대한 포괄적인 문서
- 📝 세부 작업 - 프로젝트 시작부터 완료까지 전체 워크플로
Cursor10x 시스템 전체가 이미 구현되어 있고, 파일 아키텍처, 구현 가이드, 전체 작업 시퀀스가 포함된 완벽한 프로젝트 청사진을 생성하세요!
개요
Cursor10x 메모리 시스템은 AI 보조원(특히 Claude)을 위한 영구 메모리 계층을 생성하여 다음을 보관하고 회상할 수 있도록 합니다.
- 최근 메시지 및 대화 기록
- 현재 작업 중인 활성 파일
- 중요한 프로젝트 이정표 및 결정
- 기술 요구 사항 및 사양
- 행동과 사건의 연대순 순서(에피소드)
이 메모리 시스템은 상태 비저장 AI 상호작용과 지속적인 개발 워크플로 간의 격차를 해소하여 보다 생산적이고 상황에 맞는 지원이 가능하도록 합니다.
시스템 아키텍처
메모리 시스템은 세 가지 핵심 구성 요소로 구성됩니다.
- MCP 서버 : 도구를 등록하고 요청을 처리하기 위해 모델 컨텍스트 프로토콜을 구현합니다.
- 메모리 데이터베이스 : 세션 전반에 걸쳐 영구 저장을 위해 Turso 데이터베이스를 사용합니다.
- 메모리 하위 시스템 : 메모리를 고유한 목적을 가진 특수 시스템으로 구성합니다.
메모리 유형
시스템은 세 가지 보완적 메모리 유형을 구현합니다.
- 단기 기억(STM)
- 최근 메시지와 활성 파일을 저장합니다.
- 현재 상호작용에 대한 즉각적인 맥락을 제공합니다.
- 최신성과 중요도에 따라 자동으로 우선순위를 지정합니다.
- 장기 기억(LTM)
- 이정표 및 결정과 같은 영구적인 프로젝트 정보를 저장합니다.
- 건축 및 디자인 맥락을 유지합니다.
- 중요도가 높은 정보를 무기한 보존합니다.
- 에피소드 기억
- 사건의 연대순 순서를 기록합니다
- 동작 간의 인과 관계를 유지합니다.
- 프로젝트 내역에 대한 시간적 맥락을 제공합니다.
특징
- 지속적인 컨텍스트 : 여러 세션에서 대화 및 프로젝트 컨텍스트를 유지합니다.
- 중요도 기반 저장소 : 구성 가능한 중요도 수준에 따라 정보의 우선순위를 지정합니다.
- 다차원 기억 : 단기 기억, 장기 기억, 에피소드 기억 시스템을 결합합니다.
- 종합 검색 : 모든 메모리 하위 시스템의 통합된 컨텍스트를 제공합니다.
- 상태 모니터링 : 내장된 진단 및 상태 보고 기능 포함
- 배너 생성 : 대화 시작을 위한 정보성 컨텍스트 배너를 생성합니다.
- 데이터베이스 지속성 : 자동 스키마 생성을 통해 모든 메모리 데이터를 Turso 데이터베이스에 저장합니다.
도구 문서
시스템 도구
mcp_cursor10x_generateBanner
메모리 시스템 통계 및 상태 정보가 담긴 배너를 생성합니다.
매개변수:
- 필요 없음
보고:
- 메모리 시스템 상태 및 통계를 포함하는 객체
예:
지엑스피1
mcp_cursor10x_initConversation
사용자 메시지 저장, 배너 생성, 컨텍스트 검색을 한 번에 수행하여 대화를 초기화합니다. 이 통합 도구를 사용하면 각 대화 시작 시 별도의 generateBanner, getComprehensiveContext, storeUserMessage 호출이 필요 없습니다.
매개변수:
content
(문자열, 필수): 사용자 메시지의 내용importance
(문자열, 선택 사항): 중요도 수준("낮음", "보통", "높음", "중요"), 기본값은 "낮음"입니다.metadata
(객체, 선택 사항): 메시지에 대한 추가 메타데이터
보고:
- 두 개의 섹션으로 구성된 객체:
display
: 사용자에게 표시될 배너를 포함합니다.internal
: 에이전트 사용에 대한 포괄적인 컨텍스트를 포함합니다.
예:
mcp_cursor10x_endConversation
여러 작업을 하나의 호출로 결합하여 대화를 종료합니다. 즉, 어시스턴트의 최종 메시지를 저장하고, 완료한 내용에 대한 이정표를 기록하고, 에피소드를 에피소드 메모리에 기록합니다. 이 통합 도구는 각 대화 종료 시 storeAssistantMessage, storeMilestone, recordEpisode를 별도로 호출할 필요성을 대체합니다.
매개변수:
content
(문자열, 필수): 보조자의 최종 메시지 내용milestone_title
(문자열, 필수): 기록할 마일스톤의 제목milestone_description
(문자열, 필수): 달성된 내용에 대한 설명importance
(문자열, 선택 사항): 중요도 수준("낮음", "보통", "높음", "중요"), 기본값은 "보통"입니다.metadata
(객체, 선택 사항): 모든 레코드에 대한 추가 메타데이터
보고:
- 각 작업의 상태와 결과가 있는 객체
예:
mcp_cursor10x_checkHealth
메모리 시스템과 데이터베이스 연결 상태를 점검합니다.
매개변수:
- 필요 없음
보고:
- 상태 및 진단 정보가 있는 객체
예:
mcp_cursor10x_getMemoryStats
메모리 시스템에 대한 자세한 통계를 검색합니다.
매개변수:
- 필요 없음
보고:
- 포괄적인 메모리 통계를 포함하는 객체
예:
mcp_cursor10x_getComprehensiveContext
단기 기억, 장기 기억, 에피소드 기억을 결합하여 모든 기억 하위 시스템에서 통합된 맥락을 검색합니다.
매개변수:
- 필요 없음
보고:
- 모든 메모리 시스템의 통합된 컨텍스트를 갖춘 객체
예:
단기 기억 도구
mcp_cursor10x_storeUserMessage
단기 기억 시스템에 사용자 메시지를 저장합니다.
매개변수:
content
(문자열, 필수): 메시지 내용importance
(문자열, 선택 사항): 중요도 수준("낮음", "보통", "높음", "중요"), 기본값은 "낮음"입니다.metadata
(객체, 선택 사항): 메시지에 대한 추가 메타데이터
보고:
- 상태 및 타임스탬프가 있는 객체
예:
mcp_cursor10x_storeAssistantMessage
단기 기억 시스템에 보조 메시지를 저장합니다.
매개변수:
content
(문자열, 필수): 메시지 내용importance
(문자열, 선택 사항): 중요도 수준("낮음", "보통", "높음", "중요"), 기본값은 "낮음"입니다.metadata
(객체, 선택 사항): 메시지에 대한 추가 메타데이터
보고:
- 상태 및 타임스탬프가 있는 객체
예:
mcp_cursor10x_trackActiveFile
사용자가 액세스하거나 수정하는 활성 파일을 추적합니다.
매개변수:
filename
(문자열, 필수): 추적 중인 파일의 경로action
(문자열, 필수): 파일에 수행되는 작업(열기, 편집, 닫기 등)metadata
(객체, 선택 사항): 추적 이벤트에 대한 추가 메타데이터
보고:
- 상태, 파일 이름, 작업 및 타임스탬프가 있는 객체
예:
mcp_cursor10x_getRecentMessages
단기 메모리에서 최근 메시지를 검색합니다.
매개변수:
limit
(숫자, 선택 사항): 검색할 최대 메시지 수, 기본값은 10입니다.importance
(문자열, 선택 사항): 중요도 수준별 필터링
보고:
- 상태와 메시지 배열을 포함하는 객체
예:
mcp_cursor10x_getActiveFiles
단기 메모리에서 활성 파일을 검색합니다.
매개변수:
limit
(숫자, 선택 사항): 검색할 최대 파일 수, 기본값은 10입니다.
보고:
- 상태와 활성 파일의 배열을 포함하는 객체
예:
장기 기억 도구
mcp_cursor10x_storeMilestone
장기 메모리에 프로젝트 이정표를 저장합니다.
매개변수:
title
(문자열, 필수): 마일스톤의 제목description
(문자열, 필수): 이정표에 대한 설명importance
(문자열, 선택 사항): 중요도 수준, 기본값은 "중간"입니다.metadata
(객체, 선택 사항): 마일스톤에 대한 추가 메타데이터
보고:
- 상태, 제목 및 타임스탬프가 있는 객체
예:
mcp_cursor10x_storeDecision
장기 메모리에 프로젝트 결정을 저장합니다.
매개변수:
title
(문자열, 필수): 결정의 제목content
(문자열, 필수): 결정 내용reasoning
(문자열, 선택 사항): 결정의 근거importance
(문자열, 선택 사항): 중요도 수준, 기본값은 "중간"입니다.metadata
(객체, 선택 사항): 결정에 대한 추가 메타데이터
보고:
- 상태, 제목 및 타임스탬프가 있는 객체
예:
mcp_cursor10x_storeRequirement
장기 메모리에 프로젝트 요구 사항을 저장합니다.
매개변수:
title
(문자열, 필수): 요구 사항의 제목content
(문자열, 필수): 요구 사항의 내용importance
(문자열, 선택 사항): 중요도 수준, 기본값은 "중간"입니다.metadata
(객체, 선택 사항): 요구 사항에 대한 추가 메타데이터
보고:
- 상태, 제목 및 타임스탬프가 있는 객체
예:
에피소드 기억 도구
mcp_cursor10x_recordEpisode
에피소드(행동)를 에피소드 기억에 기록합니다.
매개변수:
actor
(문자열, 필수): 작업을 수행하는 액터(사용자, 보조, 시스템)action
(문자열, 필수): 수행되는 작업 유형content
(문자열, 필수): 작업의 내용 또는 세부 정보importance
(문자열, 선택 사항): 중요도 수준, 기본값은 "낮음"입니다.context
(문자열, 선택 사항): 에피소드에 대한 컨텍스트
보고:
- 상태, 행위자, 작업 및 타임스탬프가 있는 객체
예:
mcp_cursor10x_getRecentEpisodes
에피소드 메모리에서 최근 에피소드를 검색합니다.
매개변수:
limit
(숫자, 선택 사항): 검색할 최대 에피소드 수, 기본값은 10입니다.context
(문자열, 선택 사항): 컨텍스트로 필터링
보고:
- 상태와 에피소드 배열이 있는 객체
예:
사용자 정의 지침 예시
설치
필수 조건
- Node.js 18 이상
- npm 또는 yarn 패키지 관리자
- 로컬 개발을 위한 Turso 데이터베이스 계정 또는 SQLite
Turso 데이터베이스 설정
메모리 시스템은 데이터베이스 저장을 위해 Turso(LibSQL)를 사용합니다. Turso 데이터베이스를 설정하려면 다음 단계를 따르세요.
- Turso 계정 만들기계정이 없으시다면 Turso.tech 에 가입하세요.
- Turso CLI 설치
- Turso에 로그인하세요
- 데이터베이스 생성
- 데이터베이스 URL을 얻으세요Copy
- 인증 토큰 생성Copy
구성에 사용할 데이터베이스 URL과 인증 토큰을 모두 저장합니다.
단계별 설치
- npm에서 패키지를 설치하세요Copy
- 커서 MCP 구성 만들기홈 디렉토리에서
.cursor/mcp.json
파일을 만들거나 편집하세요.다음 구성을 파일에 추가합니다.Copy실제 Turso 자격증을 사용하세요.Copy - 커서 재시작구성을 저장한 후 커서를 다시 시작하여 메모리 시스템을 로드합니다.
- 설치 확인Claude에게
mcp_cursor10x_generateBanner
도구를 실행하도록 요청하여 설치를 테스트합니다.
개발자를 위한
cursor10x-mcp 개발에 참여하고 싶다면:
- 저장소를 복제합니다Copy
- 종속성 설치
- Turso 자격 증명으로 .env.local 파일을 만듭니다.Copy
- 개발 모드에서 실행
- npm에 빌드하고 게시합니다.Copy
구성
환경 변수
다음 환경 변수를 사용하여 메모리 시스템을 구성할 수 있습니다.
TURSO_DATABASE_URL
: Turso 데이터베이스 연결을 위한 URL(필수)TURSO_AUTH_TOKEN
: Turso 데이터베이스 액세스를 위한 인증 토큰(필수)MCP_LOG_LEVEL
: 로깅 수준("오류", "경고", "정보", "디버그"), 기본값은 "정보"입니다.MCP_PORT
: HTTP 전송을 사용하는 경우 MCP 서버의 포트, 기본값은 3000입니다.
커서의 구성
.cursor/mcp.json
파일에 메모리 시스템 구성을 추가합니다.
다음 사항을 확인하세요.
/path/to/your/cursor10x-mcp/index.js
index.js 파일의 실제 경로로 바꾸세요.your-turso-database-url
Turso 데이터베이스 URL로 바꾸세요.your-turso-auth-token
Turso 인증 토큰으로 바꾸세요.- 아직 존재하지 않으면 홈 디렉토리에
.cursor
디렉토리를 만드십시오.
Cursor를 다시 시작한 후 Claude가 메모리 도구에 액세스할 수 있는지 확인하여 구성을 확인할 수 있습니다.
데이터베이스 스키마
메모리 시스템은 다음의 데이터베이스 테이블을 자동으로 생성하고 유지 관리합니다.
messages
: 사용자 및 보조자 메시지를 저장합니다.id
: 고유 식별자timestamp
: 생성 타임스탬프role
: 메시지 역할(사용자/보조자)content
: 메시지 내용importance
: 중요도 수준archived
: 메시지가 보관되었는지 여부
active_files
: 파일 활동을 추적합니다id
: 고유 식별자filename
: 파일 경로action
: 마지막으로 수행된 작업last_accessed
: 마지막 액세스 타임스탬프
milestones
: 기록 프로젝트 이정표id
: 고유 식별자title
: 마일스톤 제목description
: 자세한 설명timestamp
: 생성 타임스탬프importance
: 중요도 수준
decisions
: 상점 프로젝트 결정id
: 고유 식별자title
: 결정 제목content
: 결정 내용reasoning
: 결정 추론timestamp
: 생성 타임스탬프importance
: 중요도 수준
requirements
: 프로젝트 요구 사항을 유지합니다.id
: 고유 식별자title
: 요구사항 제목content
: 요구 사항 내용timestamp
: 생성 타임스탬프importance
: 중요도 수준
episodes
: 사건과 행동을 기록합니다id
: 고유 식별자timestamp
: 생성 타임스탬프actor
: 동작을 수행하는 배우action
: 동작의 종류content
: 작업 세부 정보importance
: 중요도 수준context
: 액션 컨텍스트
예제 워크플로
최적화된 대화 시작
새 세션 시작(대체 방법)
사용자 활동 추적
문제 해결
일반적인 문제
- 데이터베이스 연결 문제
- Turso 데이터베이스 URL과 인증 토큰이 올바른지 확인하세요.
- Turso 서비스에 대한 네트워크 연결을 확인하세요
- 방화벽 설정이 연결을 허용하는지 확인하세요.
- 누락된 데이터
- 데이터가 적절한 중요도 수준으로 저장되었는지 확인하세요.
- 검색 쿼리 매개변수(제한, 필터)를 확인하세요.
mcp_cursor10x_checkHealth()
로 데이터베이스 상태를 확인하세요.
- 성능 문제
mcp_cursor10x_getMemoryStats()
사용하여 메모리 통계를 모니터링합니다.- 데이터베이스가 너무 커지면 오래된 데이터를 보관하는 것을 고려하세요.
- 더욱 구체적인 필터를 사용하여 검색을 최적화합니다.
진단 단계
- 시스템 상태 확인:Copy
- 메모리 통계 확인:Copy
- 상태 배너 생성:Copy
중요도 수준
메모리에 항목을 저장할 때 적절한 중요도 수준을 사용하세요.
- 낮음 : 일반 정보, 일상 업무, 일상 대화
- 매체 : 유용한 컨텍스트, 표준 작업 항목, 정기 기능
- 높음 : 중요한 결정, 주요 기능, 중요한 아키텍처 요소
- 중요 : 핵심 아키텍처, 보안 문제, 데이터 무결성 문제
특허
MIT
사용 가능한 도구
단기 기억 도구
mcp_cursor10x_initConversation
: 사용자 메시지를 저장하고, 배너를 생성하고, 컨텍스트를 한 번의 작업으로 검색하여 대화를 초기화합니다.- 매개변수:
content
(필수): 사용자 메시지의 내용importance
(선택 사항, 기본값: "낮음"): 중요도 수준(낮음, 보통, 높음, 중요)metadata
(선택 사항): 메시지에 대한 추가 메타데이터
- 반환: 배너와 컨텍스트를 포함하는 객체
- 매개변수:
mcp_cursor10x_storeUserMessage
: 사용자 메시지를 단기 메모리에 저장합니다.- 매개변수:
content
(필수): 메시지 내용importance
(선택 사항, 기본값: "낮음"): 중요도 수준(낮음, 보통, 높음, 중요)metadata
(선택 사항): 메시지에 대한 추가 메타데이터
- 반환: 저장된 메시지 ID
- 매개변수:
시스템 도구
mcp_cursor10x_endConversation
: 보조자의 최종 메시지를 저장하고, 이정표를 기록하고, 에피소드를 에피소드 메모리에 기록하여 대화를 마무리합니다.- 매개변수:
content
(필수): 보조원의 최종 메시지 내용milestone_title
(필수): 완료 마일스톤의 제목milestone_description
(필수): 달성한 내용에 대한 설명importance
(선택 사항, 기본값: "중간"): 중요도 수준(낮음, 보통, 높음, 중요)metadata
(선택 사항): 작업에 대한 추가 메타데이터
- 반환: 각 작업의 상태 및 결과가 포함된 객체
- 매개변수:
mcp_cursor10x_generateBanner
: 메모리 시스템 통계 및 상태를 포함하는 배너를 생성합니다.- 매개변수: 없음
- 반환: 메모리 시스템 정보가 포함된 포맷된 배너
mcp_cursor10x_checkHealth
: 메모리 시스템과 해당 데이터베이스의 상태를 확인합니다.- 매개변수: 없음
- 반환: 건강 상태 정보
mcp_cursor10x_getMemoryStats
: 메모리 시스템에 대한 통계를 검색합니다.- 매개변수: 없음
- 반환: 메시지, 활성 파일 및 기타 메모리 구성 요소에 대한 통계
You must be authenticated.
Tools
Cursor10x 메모리 시스템은 AI 비서(특히 클로드)를 위한 영구 메모리 계층을 생성하여 AI 비서가 단기, 장기, 에피소드 메모리를 자율적으로 유지하고 회상할 수 있도록 합니다.
- 🚀 ANNOUNCING CURSOR10X SYSTEM 🚀
- Transform Your Development Process with AI-Powered Autonomous Systems
- 🔥 The Cursor10x Memory System is now part of the complete Cursor10x Platform! 🔥
- Overview
- System Architecture
- Features
- Tool Documentation
- EXAMPLE CUSTOM INSTRUCTIONS
- Installation
- Configuration
- Database Schema
- Example Workflows
- Troubleshooting
- Importance Levels
- License
- Available Tools