Skip to main content
Glama

Novyx MCP — 데스크톱 확장 프로그램

Claude Desktop용 데스크톱 확장 프로그램(.mcpb)입니다. 클릭 한 번으로 롤백, 감사 추적, 의미론적 검색 기능을 갖춘 영구적인 AI 에이전트 메모리를 설치할 수 있습니다.

주요 기능

  • 영구 메모리 — 의미론적 검색을 통해 메모리를 저장하고 불러오기

  • 타임 트래블 롤백 — 특정 시점으로 되돌려 실수 수정

  • 감사 추적 — 모든 메모리 작업에 대한 암호학적 증명

  • 지식 그래프 — 주어-술어-목적어 트리플로 메모리 연결

  • 컨텍스트 공간 — 프로젝트별로 격리된 메모리 범위

  • 로컬 우선 — API 키 없이 SQLite로 즉시 작동

  • 클라우드 업그레이드 — 선택적 클라우드 동기화, 팀 공유 및 고급 기능

120개의 도구, 6개의 리소스, 3개의 프롬프트를 포함합니다.

Related MCP server: engram-mcp

설치 방법

Anthropic 디렉토리에서 설치 (권장):

Claude Desktop → 설정 → 확장 프로그램에서 직접 설치하세요.

수동 설치:

  1. Releases에서 최신 .mcpb 파일을 다운로드합니다.

  2. 파일을 더블 클릭하거나 Claude Desktop으로 드래그하세요.

사전 요구 사항: Python 3.10 이상이 설치되어 있어야 합니다. 확장 프로그램은 uvx를 통해 novyx-mcp를 자동으로 설치하거나 기존 pip install novyx-mcp를 사용합니다.

구성

로컬 모드는 별도의 구성이 필요하지 않습니다. 확장 프로그램은 로컬 SQLite 데이터베이스와 함께 즉시 작동합니다.

선택 사항 — 클라우드 모드:

설치 중 메시지가 표시되면 Novyx API 키를 입력하세요. novyxlabs.com에서 무료 키를 받을 수 있습니다(5,000개 메모리, 신용카드 불필요).

클라우드 모드 기능:

  • 기기 간 메모리 동기화

  • RSA 서명 감사 추적

  • 팀 공유 및 컨텍스트 공간

  • 리플레이 및 코텍스 기능

사용 예시

예시 1: 메모리 저장 및 불러오기

사용자 프롬프트:

프로젝트 마감일이 3월 15일이고 React와 TypeScript를 사용한다는 것을 기억해 줘.

작동 방식: Claude가 remember 도구를 호출하여 두 개의 태그된 메모리를 저장합니다. 이후:

이 프로젝트에서 어떤 기술 스택을 사용하고 있지?

작동 방식: Claude가 의미론적 검색과 함께 recall을 호출하여 React + TypeScript에 대한 저장된 메모리를 찾고 정확하게 답변합니다.

예시 2: 실수 롤백

사용자 프롬프트:

마감일을 3월 15일이라고 잘못 말했어. 실제로는 4월 1일이야. 잘못된 메모리를 롤백하고 수정해 줘.

작동 방식: Claude가 rollback을 호출하여 잘못된 메모리를 취소한 다음, remember를 호출하여 수정된 날짜를 저장합니다. audit 추적에는 전체 기록이 표시됩니다: 원본 저장 → 롤백 → 수정된 저장.

예시 3: 지식 그래프 구축

사용자 프롬프트:

다음 관계를 추적해 줘: Alice는 프론트엔드 팀을 관리하고, Bob은 백엔드 팀을 관리하며, 두 팀 모두 Carol에게 보고해.

작동 방식: Claude가 triple을 세 번 호출하여 지식 그래프 항목을 생성합니다:

  • Alice → manages → frontend team

  • Bob → manages → backend team

  • frontend team, backend team → reports_to → Carol

나중에 "프론트엔드 팀은 누구에게 보고하지?"라고 물으면 triples 쿼리가 트리거되어 답변을 반환합니다.

예시 4: 격리된 프로젝트 컨텍스트

사용자 프롬프트:

업무 메모리와 섞이지 않도록 사이드 프로젝트를 위한 별도의 메모리 공간을 만들어 줘.

작동 방식: Claude가 create_space를 호출하여 격리된 컨텍스트를 생성합니다. 해당 공간에 저장된 메모리는 범위가 지정되어 일반 검색에는 나타나지 않습니다.

개인정보 처리방침

Novyx MCP는 두 가지 모드로 작동합니다:

로컬 모드 (기본값): 모든 데이터는 ~/.novyx/local.db의 SQLite 데이터베이스에 로컬로 저장됩니다. 외부 서버로 데이터가 전송되지 않습니다. 분석이나 텔레메트리도 없습니다.

클라우드 모드 (옵트인): API 키를 제공하면 메모리가 저장 및 동기화를 위해 Novyx API(novyx-ram-api.fly.dev)로 전송됩니다. 데이터는 전송 중(TLS) 및 저장 시 암호화됩니다. 당사는 귀하의 데이터를 제3자와 공유하지 않습니다. 전체 개인정보 처리방침은 novyxlabs.com/privacy에서 확인하세요.

API 키를 추가하거나 제거하여 언제든지 모드를 전환할 수 있습니다.

데이터 보존: 로컬 데이터는 삭제할 때까지 유지됩니다. 클라우드 데이터는 삭제하거나 계정을 폐쇄할 때까지 유지됩니다. 감사 추적은 설계상 변경할 수 없습니다.

개인정보 관련 문의는 blake@novyxlabs.com으로 연락해 주세요.

지원

작동 원리

이 데스크톱 확장 프로그램은 Python novyx-mcp 서버를 자식 프로세스로 생성하는 가벼운 Node.js 래퍼입니다. Node.js 계층은 프로세스 수명 주기를 처리하고, Python 서버는 모든 MCP 로직을 처리합니다.

실행 순서:

  1. uvx novyx-mcp (가장 빠름 — 설치 불필요)

  2. python3 -m novyx_mcp (pip 설치 시)

  3. novyx-mcp (pipx 설치 시)

라이선스

MIT

Available Tools

23 tools
add_tripleA

Add a knowledge graph triple (subject -> predicate -> object).

Entities are auto-created by name if they don't exist.

Args:
    subject: The subject entity name.
    predicate: The relationship predicate.
    object_name: The object entity name.

Returns:
    JSON string with the created triple details.

Inputs: subject (required), predicate (required), object_name (required). Returns: result

auditA
Read-only

Get the audit trail of memory operations.

Args:
    limit: Maximum number of audit entries to return (default 20).
    operation: Optional filter by operation type (CREATE, UPDATE, DELETE, ROLLBACK).

Returns:
    JSON string with audit trail entries.

Inputs: limit, operation. Returns: result

cortex_insightsA
Read-only

List auto-generated memory insights.

Cortex detects patterns across your memories and generates insights automatically.
Requires Enterprise tier or Novyx Cloud.

Args:
    limit: Maximum insights to return (default 20).

Returns:
    JSON string with generated insights.

Inputs: limit. Returns: result

cortex_runA

Manually trigger a Cortex cycle.

Runs consolidation (merge duplicate memories) and reinforcement (boost frequently
recalled memories, decay forgotten ones). Normally runs automatically every 6 hours.
Requires Pro tier or Novyx Cloud.

Returns:
    JSON string with cycle results (consolidated, reinforced counts).

Inputs: no named parameters. Returns: result

cortex_statusA
Read-only

Get Cortex autonomous intelligence status.

Shows whether Cortex is enabled, last run time, and consolidation/reinforcement stats.
Requires Pro tier or Novyx Cloud.

Returns:
    JSON string with Cortex status and last run info.

Inputs: no named parameters. Returns: result

create_spaceA

Create a shared context space for multi-agent collaboration.

Spaces let multiple agents share memories with fine-grained permissions.
The creator is the owner and can grant read/write access to other agents or tenants.

Args:
    name: Name for the space.
    description: Optional description of the space's purpose.
    allowed_agents: Optional list of agent IDs that can access this space.
    tags: Optional tags for the space.

Returns:
    JSON string with the created space details including space_id.

Inputs: name (required), tags, description, allowed_agents. Returns: result

delete_spaceB
Destructive

Delete a context space (owner only).

Args:
    space_id: The space ID to delete.

Returns:
    JSON string indicating success.

Inputs: space_id (required). Returns: result

forgetA
Destructive

Delete a memory by its UUID.

Args:
    memory_id: The UUID of the memory to delete.

Returns:
    JSON string indicating success or failure.

Inputs: memory_id (required). Returns: result

list_memoriesA
Read-only

List stored memories with optional tag filtering.

Args:
    limit: Maximum number of memories to return (default 50).
    tags: Optional tag filter to narrow results.

Returns:
    JSON string with the list of memories.

Inputs: tags, limit. Returns: result

list_spacesA
Read-only

List all context spaces you can access.

Returns spaces you own and spaces shared with you.

Returns:
    JSON string with list of spaces and their memory counts.

Inputs: no named parameters. Returns: result

memory_statsA
Read-only

Get memory statistics for the current account.

Returns:
    JSON string with total memories, average importance, tag distribution, etc.

Inputs: no named parameters. Returns: result

query_triplesA
Read-only

Query knowledge graph triples with optional filters.

At least one filter should be provided. Returns all matching triples.

Args:
    subject: Filter by subject entity name.
    predicate: Filter by relationship predicate.
    object_name: Filter by object entity name.

Returns:
    JSON string with matching triples.

Inputs: subject, predicate, object_name. Returns: result

recallA
Read-only

Search memories semantically using natural language.

Args:
    query: Natural language search query.
    limit: Maximum number of results to return (default 5).
    tags: Optional tag filter.
    min_score: Minimum similarity score 0-1 (default 0).

Returns:
    JSON string with matching memories and their scores.

Inputs: query (required), tags, limit, min_score. Returns: result

rememberA

Store a memory observation in Novyx.

Args:
    observation: The memory content to store.
    tags: Optional list of tags for categorization.
    importance: Importance score 1-10 (default 5).
    context: Optional context string.
    ttl_seconds: Optional time-to-live in seconds. Memory auto-expires after this duration.

Returns:
    JSON string with the stored memory UUID and details.

Inputs: observation (required), tags, context, importance, +1 more. Returns: result

replay_diffA
Read-only

Diff memory state between two timestamps.

Shows what was added, removed, and modified in a time range.
Requires Pro tier or Novyx Cloud.

Args:
    start: Start timestamp (ISO).
    end: End timestamp (ISO).

Returns:
    JSON string with added, removed, and modified memories.

Inputs: end (required), start (required). Returns: result

replay_lifecycleA
Read-only

Full biography of a single memory.

Shows creation, every update, every recall, every link, and deletion.
Use this to understand why a memory exists and how it evolved.
Requires Pro tier or Novyx Cloud.

Args:
    memory_id: UUID of the memory to inspect.

Returns:
    JSON string with the memory's full lifecycle events.

Inputs: memory_id (required). Returns: result

replay_snapshotA
Read-only

Reconstruct memory state at a specific point in time.

Returns all memories and their link graph as they existed at timestamp T.
Requires Pro tier or Novyx Cloud.

Args:
    at: ISO timestamp to reconstruct state at.
    limit: Maximum memories to return (default 500).

Returns:
    JSON string with memory snapshot and edges.

Inputs: at (required), limit. Returns: result

replay_timelineA
Read-only

Get the full timeline of memory operations. The tape you scrub through.

Shows every create, update, delete, and rollback event with timestamps.
Requires Pro tier or Novyx Cloud.

Args:
    since: Start of time range (ISO timestamp).
    until: End of time range (ISO timestamp).
    operations: Comma-separated filter: create, update, delete, rollback.
    limit: Maximum entries to return (default 100).

Returns:
    JSON string with timeline entries.

Inputs: limit, since, until, operations. Returns: result

rollbackA
Destructive

Rollback memory to a point in time.

Supports ISO timestamps (e.g. '2026-01-15T10:00:00Z') and relative time
expressions (e.g. '2 hours ago').

Args:
    target: ISO timestamp or relative time expression.
    dry_run: If true, preview changes without applying them.

Returns:
    JSON string with rollback results or preview.

Inputs: target (required), dry_run. Returns: result

share_spaceA

Share a space/tag with another user by email.

Requires Novyx Cloud — not available in local mode.

Args:
    tag: The tag or space tag to share.
    email: Email address of the recipient.
    permission: Access level — 'read' or 'write' (default 'read').

Returns:
    JSON string with the share token and join URL.

Inputs: tag (required), email (required), permission. Returns: result

space_memoriesA
Read-only

List or search memories within a context space.

Args:
    space_id: The space ID to query.
    query: Optional search query to filter memories semantically.
    limit: Maximum number of memories to return (default 50).

Returns:
    JSON string with memories in the space.

Inputs: space_id (required), limit, query. Returns: result

update_spaceA

Update a context space (owner only).

Args:
    space_id: The space ID to update.
    name: New name for the space.
    description: New description.
    allowed_agents: Updated list of allowed agent IDs.
    tags: Updated tags.

Returns:
    JSON string with the updated space details.

Inputs: space_id (required), name, tags, description, +1 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 23 tools

    Disambiguation4/5

    Most tools have distinct purposes, but there is some overlap between audit and replay_timeline (both show operations) and between list_memories and recall (list vs search). However, descriptions clarify differences.

    Naming Consistency3/5

    Naming conventions are mixed: some use verb_noun (remember, create_space), some noun_noun (cortex_insights, memory_stats), and some single word (audit). Not fully consistent.

    Tool Count5/5

    23 tools is well-scoped for a comprehensive memory system with knowledge graphs, spaces, replay, and Cortex features. Each tool serves a distinct purpose.

    Completeness3/5

    Covers most CRUD operations for memories and spaces, but lacks update_memory and update/delete for triples. Replay and Cortex features are thorough.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers