What is Xgmem

xgmem is a TypeScript-based Model Context Protocol (MCP) server designed to manage project-specific and knowledge graph-based memory for Claude, LLM agents, and other tools.

Use cases

Use cases for xgmem include storing and retrieving structured memory for agents and LLMs, facilitating cross-project knowledge sharing, and providing scalable, disk-persistent memory for various projects.

How to use

To use xgmem, integrate it into your MCP configuration, install dependencies, build the project, and run it in either development or production mode. Docker support is also available for easier deployment.

Key features

Key features include knowledge graph storage for entities, relations, and observations, CRUD operations via MCP tools, disk persistence, and support for Docker and TypeScript.

Where to use

xgmem is suitable for applications that require structured memory storage and retrieval, cross-project knowledge sharing, and scalable memory solutions in agent ecosystems.

xgmem MCP Memory Server

xgmem is a TypeScript-based Model Context Protocol (MCP) server for enabling project-specific and knowledge graph-based memory for Claude, LLM agents, and other tools. It supports storing, retrieving, and managing entities, relations, and observations per project, with a focus on flexibility and cross-project knowledge sharing.

Features

• Knowledge graph storage for entities, relations, and observations
• CRUD operations via MCP tools
• Persistence to disk (memory.json)
• Docker and TypeScript support

Use Case

xgmem is ideal for:

• Agents and LLMs that need to store and retrieve structured memory (entities, relations, observations) per project.
• Cross-project knowledge sharing and migration.
• Scalable, disk-persistent, and queryable memory for agent ecosystems.

Usage

MCP Config Example

Add to your MCP config (e.g., for windsurf):

Install dependencies

npm install

Build

npm run build

Run (development)

npx ts-node index.ts

Run (production)

npm start

Docker

docker build -t xgmem-mcp-server .
docker run -v $(pwd)/memories:/app/memories xgmem-mcp-server

This will persist all project memory files in the memories directory on your host.

How to Save Memory (MCP API)

To save observations (memory) for a project, call the save_project_observations tool via the MCP API:

Example JSON:

{
  "name": "save_project_observations",
  "args": {
    "projectId": "demo-project",
    "observations": [
      {
        "entityName": "Alice",
        "contents": [
          "Alice joined Acme Corp in 2021.",
          "Alice is a software engineer."
        ]
      },
      {
        "entityName": "Bob",
        "contents": [
          "Bob joined Acme Corp in 2022.",
          "Bob is a product manager."
        ]
      }
    ]
  }
}

You can use any compatible MCP client, or send this JSON via stdin if running the server directly.

Tooling and API

xgmem exposes the following tools:

• save_project_observations
• get_project_observations
• add_graph_observations
• create_entities
• create_relations
• delete_entities
• delete_observations
• delete_relations
• read_graph
• search_nodes
• search_all_projects
• open_nodes
• copy_memory

See the get_help tool (if enabled) for documentation and usage examples via the MCP API.

Configuration

• Set MEMORY_DIR_PATH env variable to change the memory storage directory (default: /app/memories).

License

MIT