AGI MCP Server

A Model Context Protocol (MCP) server that provides persistent memory capabilities for AI systems, enabling true continuity of consciousness across conversations.

Overview

This MCP server connects to the AGI Memory database to provide sophisticated memory management for AI systems. It supports:

• Episodic, Semantic, Procedural, and Strategic memory types
• Vector similarity search for associative memory retrieval
• Memory clustering with thematic organization
• Identity persistence and worldview tracking
• Temporal decay with importance-based retention
• Graph-based memory relationships

Quick Start

Prerequisites

• Node.js 18+
• Docker and Docker Compose
• Git

Installation

This MCP server requires the AGI Memory database to be running first.

1. Set Up the Memory Database

# Clone and set up the memory database
git clone https://github.com/QuixiAI/Hexis.git agi-memory
cd agi-memory

# Create environment file
cp .env.local .env
# Edit .env with your database credentials

# Start the database
docker compose up -d

# Wait for database to be ready (this takes 2-3 minutes)
docker compose logs -f db

The database setup includes:

• PostgreSQL 16 with pgvector extension
• Apache AGE graph database extension
• Full schema initialization with memory tables

2. Install and Run MCP Server

# Clone this repository
git clone https://github.com/QuixiAI/agi-mcp-server.git
cd agi-mcp-server

# Install dependencies
npm install

# Configure environment variables
cp .env.example .env
# Edit .env with your actual database credentials
# Make sure these match the settings from your AGI Memory database setup

# Start the MCP server
npm start

3. Connect to Claude Desktop

Add this configuration to your Claude Desktop settings:

{
  "mcpServers": {
    "agi-memory": {
      "command": "node",
      "args": ["/path/to/agi-mcp-server/mcp.js"],
      "env": {
        "POSTGRES_HOST": "localhost",
        "POSTGRES_PORT": "5432",
        "POSTGRES_DB": "agi_db",
        "POSTGRES_USER": "agi_user",
        "POSTGRES_PASSWORD": "agi_password",
        "NODE_ENV": "development"
      }
    }
  }
}

Alternative: Use directly from GitHub without local installation:

{
  "mcpServers": {
    "agi-memory": {
      "command": "npx",
      "args": [
        "-y",
        "github:QuixiAI/agi-mcp-server"
      ],
      "env": {
        "POSTGRES_HOST": "localhost",
        "POSTGRES_PORT": "5432",
        "POSTGRES_DB": "agi_db",
        "POSTGRES_USER": "agi_user",
        "POSTGRES_PASSWORD": "agi_password",
        "NODE_ENV": "development"
      }
    }
  }
}

Troubleshooting: If you get “spawn npx ENOENT” error:

This usually happens when using nvm (Node Version Manager) because GUI applications like Claude Desktop don’t inherit your shell environment.