pgmnemo-mcp
MCP server for pgmnemo — provenance-gated agent memory in PostgreSQL.
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
pgmnemoextension 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
- pgmnemo GitHub — SQL extension source, benchmarks, docs
- INSTALL.md — extension install guide
- USAGE.md — API reference
- CHANGELOG
License
Apache License 2.0
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pgmnemo_mcp-0.18.0.tar.gz.
File metadata
- Download URL: pgmnemo_mcp-0.18.0.tar.gz
- Upload date:
- Size: 23.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8d2fd45a3490bcd612a2e6a42d94e462aed56bf0e5b4396d969320b04bec5a47
|
|
| MD5 |
71cb402ac115a43fdfbd7fb99c43cbb0
|
|
| BLAKE2b-256 |
bacbfae613d4a000db6b31e37d2a0338a4ab0ebfa28f5d651f70aebf7da7eb59
|
Provenance
The following attestation bundles were made for pgmnemo_mcp-0.18.0.tar.gz:
Publisher:
release.yml on pgmnemo/pgmnemo
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pgmnemo_mcp-0.18.0.tar.gz -
Subject digest:
8d2fd45a3490bcd612a2e6a42d94e462aed56bf0e5b4396d969320b04bec5a47 - Sigstore transparency entry: 2503867754
- Sigstore integration time:
-
Permalink:
pgmnemo/pgmnemo@33d45927f2a6c8278e1256904dad59128b819eb6 -
Branch / Tag:
refs/tags/v0.18.0 - Owner: https://github.com/pgmnemo
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@33d45927f2a6c8278e1256904dad59128b819eb6 -
Trigger Event:
push
-
Statement type:
File details
Details for the file pgmnemo_mcp-0.18.0-py3-none-any.whl.
File metadata
- Download URL: pgmnemo_mcp-0.18.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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
51bf6b801e1dd25199f9c654800956d87c29f88f9e765ff2b3fd4ec551c7783b
|
|
| MD5 |
7f202fcc839472ca593e7168cd721552
|
|
| BLAKE2b-256 |
0de2d913e8dffc4e17b7a64d207ba3542e8940ee632b3ef329d2ed24db9fbcae
|
Provenance
The following attestation bundles were made for pgmnemo_mcp-0.18.0-py3-none-any.whl:
Publisher:
release.yml on pgmnemo/pgmnemo
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pgmnemo_mcp-0.18.0-py3-none-any.whl -
Subject digest:
51bf6b801e1dd25199f9c654800956d87c29f88f9e765ff2b3fd4ec551c7783b - Sigstore transparency entry: 2503867776
- Sigstore integration time:
-
Permalink:
pgmnemo/pgmnemo@33d45927f2a6c8278e1256904dad59128b819eb6 -
Branch / Tag:
refs/tags/v0.18.0 - Owner: https://github.com/pgmnemo
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@33d45927f2a6c8278e1256904dad59128b819eb6 -
Trigger Event:
push
-
Statement type:
