trackmcp
Back to directory
drakonkat

neural-memory

View on GitHub

Neural memory

0 stars JavaScriptOthers Updated Jun 6, 2026

Documentation

๐Ÿง  Neural Memory v2.0

> โš ๏ธ IMPORTANT NOTICE: This is an experimental MCP (Model Context Protocol) tool. While it has shown promising results when used locally, it is still under active development and may evolve over time. Feedback and contributions are highly appreciated! Please report any issues, suggestions, or feature requests on our GitHub Issues page. Your input helps make this tool better for everyone! nya~


Model Context Protocol (MCP) system for knowledge memorization and contextual retrieval.


๐Ÿš€ Try Neural Memory NOW!

Want to try it right away in your Cline? Add this configuration to your `cline_mcp_settings.json`:

json
{
  "mcpServers": {
    "neural-memory": {
      "timeout": 120,
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@drakonkat/neural-memory@latest"
      ]
    }
  }
}

For Local Development

json
{
  "mcpServers": {
    "neural-memory": {
      "timeout": 120,
      "type": "stdio",
      "command": "node",
      "args": [
        "./neural-memory/src/index.js"
      ]
    }
  }
}

> โš ๏ธ Note: Replace the path with your local project path!


What's New in v2.0

๐ŸŽฏ Unified Database

  • No more separate databases per project! All memory resides in a single SQLite database
  • Faster, simpler, zero configuration

๐ŸŽ“ Skills Framework

  • Rigid schema for registering skills with consistent structure
  • `framework`, `language`, `filePattern`, `learnSteps`, `useCases`
  • Automatic context-based suggestions

๐Ÿ“Š HTML Reports

  • Generate visual reports of your memory
  • Statistics, most used skills, recent work

Quick Start

javascript
import { initialize, handleMcpRequest } from 'neural-memory';

// Initialize the service
await initialize();

// Add a node
await handleMcpRequest('add_node', {
  keywords: ['fastify', 'middleware', 'auth'],
  content: 'Implementation of JWT middleware...',
  type: 'generic'
});

// Register a skill
await handleMcpRequest('register_skill', {
  name: 'Fastify CRUD API',
  framework: 'fastify',
  language: 'javascript',
  filePattern: '**/*.service.js',
  learnSteps: [
    '1. Initialize project',
    '2. Create validation schema',
    '3. Implement handler'
  ],
  useCases: [
    'Create REST API',
    'Handle standardized errors'
  ]
});

// Search for skills
const skills = await handleMcpRequest('suggest_skills', {
  currentKeywords: ['fastify', 'api'],
  domain: 'javascript'
});

// Save context
await handleMcpRequest('save_context_snapshot', {
  summary: 'Refactoring 80% complete',
  pendingTasks: ['Integration testing', 'Deploy to staging'],
  learnings: ['Prisma requires explicit migrations']
});

// Generate report
const report = await handleMcpRequest('get_memory_report', {
  format: 'html'
});

Available Tools

Node Management

ToolDescription
`add_node`Add node to memory
`search_nodes`Search nodes (with FTS5 + confidence)
`delete_node`Delete node

Skills Framework

ToolDescription
`register_skill`Register skill (rigid schema)
`suggest_skills`Suggest skills

Context Management

ToolDescription
`save_context_snapshot`Save context snapshot
`restore_context`Restore context

Reports

ToolDescription
`get_memory_report`JSON/HTML report

Node Types

TypePriorityUse Case
`skill`โญโญโญKnowledge skill
`error`โญโญโญResolved error
`operation`โญโญHow-to
`convention`โญโญNaming rules
`edge_case`โญโญEdge case
`pattern`โญDesign pattern
`task`โญCompleted task
`generic`โญGeneric node

Confidence Scoring

The system calculates a confidence score (0.0-1.0) for each result based on:

  • BM25 Score (35%) - Full-text search ranking
  • Keyword Match (25%) - Keywords overlap
  • Recency Bonus (10%) - Recent nodes preferred
  • Type Score (15%) - Skills/errors are more important
  • Weight (15%) - Manual weight

Rigid Skill Schema

json
{
  "name": "Skill Name",
  "framework": "fastify|react|prisma|...",
  "language": "javascript|typescript|python|...",
  "filePattern": "**/*.service.js",
  "learnSteps": ["Step 1", "Step 2"],
  "useCases": ["Case 1", "Case 2"],
  "implementation": "// Code...",
  "examples": ["file1.js"],
  "prerequisites": ["Prerequisite 1"]
}

Installation

bash
npm install neural-memory

Database

The unified database is located at:

code
data/neural-memory-unified.sqlite

License

MIT

Frequently asked questions

What is neural-memory?

neural-memory is Neural memory

How do I install neural-memory?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is neural-memory open source?

Yes โ€” it is hosted on GitHub at https://github.com/drakonkat/neural-memory.

Related MCP tools

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP