A

AGI MCP Server

Enables persistent memory for AI systems by providing tools for episodic, semantic, and procedural d...

40 views
0 installs
Updated Feb 5, 2026
Not audited
Tools I Recommend
Enables persistent memory for AI systems by providing tools for episodic, semantic, and procedural data storage through a vector-and-graph-enhanced database. It allows models to maintain long-term continuity using similarity search, thematic clustering, and identity tracking.
  1. Open the FastMCP connection interface

    • Click the "Install Now" button to open the FastMCP / MCP connection UI where you can add environment variables.
  2. Clone the AGI Memory repository (where the DB runs)

    • Run:
      git clone https://github.com/cognitivecomputations/agi-memory.git
      cd agi-memory
      
    • (This repo contains the DB setup and the example env file.) (github.com)
  3. Create and edit the database .env file to obtain the credentials

    • Copy the example environment file and open it for editing:
      cp .env.local .env
      # edit .env with your database credentials
      
    • In .env set (or confirm) these values — these are the exact keys you will later paste into FastMCP:
      • POSTGRES_HOST (e.g., localhost)
      • POSTGRES_PORT (default: 5432)
      • POSTGRES_DB (e.g., agi_db)
      • POSTGRES_USER (e.g., agi_user)
      • POSTGRES_PASSWORD (choose a strong password)
      • NODE_ENV (set to development)
    • Save .env. (github.com)
  4. Start the memory database and confirm host/port

    • Start the DB:
      docker compose up -d
      
    • Wait for the DB to initialize, then tail the DB logs to confirm readiness (the DB typically listens on port 5432). Example:
      docker compose logs -f db
      
    • If docker-compose maps the DB port to the host, use the mapped host and port (commonly POSTGRES_HOST=localhost and POSTGRES_PORT=5432). (github.com)
  5. (Optional) Generate a strong POSTGRES_PASSWORD

    • Generate a secure password locally and paste it into .env:
      openssl rand -base64 32
      
    • Store that password in your .env and also in the FastMCP fields below.
  6. Verify you can connect to the DB (quick test)

    • From the agi-memory directory, you can exec into the DB container or use psql to verify credentials:
      # from host (if port mapped)
      psql -h localhost -p 5432 -U <POSTGRES_USER> -d <POSTGRES_DB>
      # or, exec into container
      docker compose exec db psql -U <POSTGRES_USER> -d <POSTGRES_DB>
      
    • If the connection succeeds, your credentials are correct.
  7. Enter the values into the FastMCP connection interface

    • In the FastMCP / MCP connection UI (opened via "Install Now"), create or edit the AGI MCP server entry and paste the environment variable names and values exactly as below:
      • POSTGRES_HOST = <value from .env>
      • POSTGRES_PORT = <value from .env>
      • POSTGRES_DB = <value from .env>
      • POSTGRES_USER = <value from .env>
      • POSTGRES_PASSWORD = <value from .env>
      • NODE_ENV = development
    • Save the connection entry in the FastMCP UI.
  8. Start or test the MCP server using the same env values

    • To validate end-to-end (optional), run the MCP server locally with the env values:
      POSTGRES_HOST=localhost POSTGRES_PORT=5432 POSTGRES_DB=agi_db POSTGRES_USER=agi_user POSTGRES_PASSWORD=your_password NODE_ENV=development node mcp.js
      
    • You should see a startup message like: "Memory MCP Server running on stdio" if the connection works. (If you used the npx/remote option, ensure the FastMCP entry uses the same env values.)
  9. If anything fails — double-check

    • Confirm the DB container is running and that .env values match the docker-compose settings (port mapping, service names).
    • Inspect docker compose logs for errors and re-run the verification steps above. (github.com)
  10. Notes and security

    • Keep POSTGRES_PASSWORD and .env private — do not commit them to git.
    • If you need to rotate the DB password later, update it in the database .env (or DB), then update the FastMCP entry with the new POSTGRES_PASSWORD.

Quick Start

View on GitHub

More for Memory Management

View All →

More for AI and Machine Learning

View All →

Similar MCP Servers

Report Issue

Thank you! Your issue report has been submitted successfully.