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.19.1)

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.19.0.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.19.0-py3-none-any.whl (19.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: pgmnemo_mcp-0.19.0.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.19.0.tar.gz
Algorithm Hash digest
SHA256 97274229d4de382fd6177dc5bb95a57f5d666c9cd622d9613eaa2701b534e8a6
MD5 cb8e74043b8b58fbe2a923e238fee31e
BLAKE2b-256 84e74dd500f2450027b903e5c4699a7709c85ff492f43cf3e583c16c43a9d350

See more details on using hashes here.

Provenance

The following attestation bundles were made for pgmnemo_mcp-0.19.0.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.19.0-py3-none-any.whl.

File metadata

  • Download URL: pgmnemo_mcp-0.19.0-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.19.0-py3-none-any.whl
Algorithm Hash digest
SHA256 855c3936497cae5e1f222fcf294f51dbdc4d665927e592149cdc8f475c40a17f
MD5 da5983dda20735b50c8e7351f28c2ecd
BLAKE2b-256 dc1a4348af23f9f7e2e01e8ad920868f4925fb82dc2fed7e4d77e5e6f5dd3b37

See more details on using hashes here.

Provenance

The following attestation bundles were made for pgmnemo_mcp-0.19.0-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