README - @memoer-mcp by geli2001

@memoer-mcp

A minimal, pluggable memory management library for Node.js, inspired by OpenMemory. Supports local SQLite storage, semantic search (Qdrant), and OpenAI embeddings. No web server, no frontend—just a programmatic API.

Features

Add, list, update, delete memories
Semantic search (Qdrant)
User, app, and category support
Local SQLite (via Prisma)
TypeScript-first

Getting Started

Install dependencies:
```
npm install
```
Initialize the database:
```
npx prisma migrate dev --name init
```

Configure the MCP: Create or update your MCP configuration file (e.g., mcp_config.json) as follows:

{
  "memoer-mcp": {
    "command": "npx",
    "args": ["memoer-mcp@latest"],
    "env": {
      "DATABASE_URL": "file:/Users/{your_username}/{any_folder_path}/memoer.db" //macOS example
    }
  }
}

Use the library in your project:

import { MemoerMCP } from "@memoer-mcp";

const memoer = new MemoerMCP();

// Example: Adding a memory
await memoer.addMemory({
  title: "My First Memory",
  content: "This is the content of my first memory.",
  category: "Personal"
});

// Example: Listing memories
const memories = await memoer.listMemories();
console.log(memories);

Development

Edit the Prisma schema in prisma/schema.prisma
Run npx prisma generate after changes
Source code in src/

This library is now fully functional and ready for use in your projects!


### MCP Configuration Example

In your `mcp_config.json`, you can configure the `memoer-mcp` command as follows:

```json
{
  "memoer-mcp": {
    "command": "npx",
    "args": ["memoer-mcp@latest"],
    "env": {
      "DATABASE_URL": "file:/Users/{your_username}/{any_folder_path}/memoer.db" //macOS example
    }
  }
}

Explanation of Configuration

command: This specifies the command to run, which in this case is npx to execute the memoer-mcp package.
args: This is an array of arguments passed to the command. Here, it specifies the package to run.
env: This section allows you to set environment variables needed for your application. The DATABASE_URL points to your SQLite database file.

Usage

With this setup, you can now run memoer-mcp from your command line or integrate it into your application as shown in the examples. This configuration allows you to manage memories effectively using the memoer-mcp library.

If you have any further questions or need additional examples, feel free to ask!