MemoryGate

MemoryGate is a production-ready MCP server that provides durable memory for AI agents. It combines structured storage with semantic search, OAuth-based authentication, and lifecycle controls for retention and archiving.

Highlights

• 20 MCP tools for storage, retrieval, knowledge graph, and cold storage.

• OAuth 2.0 + PKCE for MCP clients, plus Google/GitHub login for users.

• API keys with bcrypt hashing and prefix-based lookup.

• Postgres + pgvector for semantic search; SQLite fallback for local/dev.

• Retention engine with hot/cold tiers, summaries, tombstones, and archives.

• Metadata-only audit logging.

• Rate limiting, security headers, and request size limits by default.

Related MCP server: Kirok

Architecture

• core/ contains shared business logic and models.

• app/ wires FastAPI middleware, routes, and OAuth flows.

• core/mcp registers FastMCP tools and exposes SSE/streamable HTTP.

Endpoints:

• /mcp/ - SSE MCP transport (authenticated).

• /MemoryGate - Alias endpoint for streamable HTTP MCP.

• /auth/* - OAuth login, client credentials, API key management.

• /oauth/* and /.well-known/* - MCP OAuth discovery and PKCE flow.

• /health - Health check.

Quick Start (Local)

Install deps:

pip install -r requirements.txt
pip install -r requirements-postgres.txt

Configure environment (Postgres + pgvector):

export DATABASE_URL="postgresql://user:password@localhost:5432/memorygate"
export OPENAI_API_KEY="sk-..."
export PSTRYDER_DESKTOP="client-id"
export PSTRYDER_DESKTOP_SECRET="client-secret"
export PSTRYDER_DESKTOP_REDIRECT_URIS="https://claude.ai/api/mcp/callback"

Run:

uvicorn app.main:asgi_app --host 0.0.0.0 --port 8080

Verify:

curl http://localhost:8080/health

For local dev without auth, you can set REQUIRE_MCP_AUTH=false.

Agent Usage (Example)

# Bootstrap
memory_bootstrap(ai_name="Kee", ai_platform="Claude")

# Initialize a session
memory_init_session(
    conversation_id="uuid",
    title="OAuth integration",
    ai_name="Kee",
    ai_platform="Claude",
)

# Store an observation
memory_store(
    observation="Completed OAuth 2.0 + PKCE integration",
    confidence=0.95,
    domain="technical_milestone",
    evidence=["Deployment successful"]
)

MCP Tool Set

• Session and docs: memory_init_session, memory_bootstrap, memory_user_guide

• Storage: memory_store, memory_store_document, memory_store_concept, memory_update_pattern

• Retrieval: memory_search, memory_recall, memory_get_concept, memory_get_pattern, memory_patterns, memory_stats

• Knowledge graph: memory_add_concept_alias, memory_add_concept_relationship, memory_related_concepts

• Cold storage: search_cold_memory, archive_memory, rehydrate_memory, list_archive_candidates

Documentation

See docs/INDEX.md for the full documentation set.

License

Apache 2.0 - see LICENSE.