pgmnemo-mcp

MCP server for pgmnemo — provenance-gated agent memory in PostgreSQL.

PyPI License Python

pgmnemo-mcp is an MCP server that exposes pgmnemo's ingest and recall capabilities as tool calls for AI agents and LLM hosts (Claude Desktop, Cursor, Zed, etc.).

Requirements

  • Python ≥ 3.11
  • A PostgreSQL database with pgmnemo extension installed (CREATE EXTENSION pgmnemo CASCADE;)
  • pgmnemo ≥ 0.5.0 (install guide)

Install

pip install pgmnemo-mcp

Quick start

# Set the database URL
export DATABASE_URL="postgresql://user:pass@localhost/mydb"

# Start the MCP server (stdio transport)
pgmnemo-mcp

Add to Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "pgmnemo": {
      "command": "pgmnemo-mcp",
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost/mydb"
      }
    }
  }
}

Configuration

Variable Default Description
DATABASE_URL postgresql://localhost/pgmnemo libpq connection string
MCP_PORT 8765 Port for HTTP/SSE transport (optional)

Tools exposed

Tool Arguments (all top-level) Description
pgmnemo.ingest text (req), role, topic, importance, project_id, commit_sha, artifact_hash, metadata Store a lesson
pgmnemo.recall query (req), top_k Retrieve relevant lessons

ingest arguments are top-level — do not nest them under metadata. Defaults: role="mcp_agent", topic="general", importance=3, project_id=1. Pass commit_sha or artifact_hash to satisfy the provenance gate (without one the lesson is a "ghost", excluded from recall by default).

Usage

# Smoke test — verify DB connectivity
DATABASE_URL=postgresql://user:pass@host/db python -m pgmnemo_mcp --smoke

# SSE transport (for web-based MCP hosts)
MCP_PORT=8765 pgmnemo-mcp

MCP Registry

Field Value
Server name pgmnemo
Entry point pgmnemo-mcp
Transport stdio (default) · SSE (MCP_PORT)

Links

License

Apache License 2.0

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.20.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Alex_Gaidabura from gravatar.com Alex_Gaidabura

License

Apache-2.0

Requires

Python >=3.11

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pgmnemo_mcp-0.18.1.tar.gz (23.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pgmnemo_mcp-0.18.1-py3-none-any.whl (19.3 kB view details)

Uploaded Python 3

File details

Details for the file pgmnemo_mcp-0.18.1.tar.gz.

File metadata

  • Download URL: pgmnemo_mcp-0.18.1.tar.gz
  • Upload date:
  • Size: 23.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pgmnemo_mcp-0.18.1.tar.gz
Algorithm Hash digest
SHA256 19a0bbd3504b9a06a4c53d95f213694635478dadfbaea2e7c049769231743edb
MD5 2af8085ab5fbecfa4b3afd61aeeb8b1f
BLAKE2b-256 4dfd4beeac4ebfc7ca0a20378ee5743694f7108fd31def2ce918f0b83e104ff8

See more details on using hashes here.

Provenance

The following attestation bundles were made for pgmnemo_mcp-0.18.1.tar.gz:

Publisher: release.yml on pgmnemo/pgmnemo

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pgmnemo_mcp-0.18.1-py3-none-any.whl.

File metadata

  • Download URL: pgmnemo_mcp-0.18.1-py3-none-any.whl
  • Upload date:
  • Size: 19.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pgmnemo_mcp-0.18.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f73836b8f982c53eca21fbe7219107208f6dcd6e244d4499a9783e16dadff4d5
MD5 f255cfb085c0f74f13eade3c3ac7eca6
BLAKE2b-256 a7e3064b04527cf5b3d304765d5b7f8ab6a79921fa2be2bc232311218fb618a0

See more details on using hashes here.

Provenance

The following attestation bundles were made for pgmnemo_mcp-0.18.1-py3-none-any.whl:

Publisher: release.yml on pgmnemo/pgmnemo

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page