Skip to main content
Glama
genpark-agent-hybrid-memory-retriever-skill

genpark-agent-hybrid-memory-retriever-skill

Official
by Alpha-Park

genpark-agent-hybrid-memory-retriever-skill

Python 3.9+ License MIT MCP Compatible GenPark AI Zero Dependencies

🌐 GenPark MCP Hub • 📦 GenPark Official • 📖 Documentation


📌 Overview & Capability

genpark-agent-hybrid-memory-retriever-skill is a deterministic, high-performance, zero-dependency Python tool and native Model Context Protocol (MCP) server designed for autonomous AI agents, multi-agent frameworks (LangGraph, CrewAI, AutoGen, OpenAI Swarm), and developer environments (Cursor, Windsurf, Claude Desktop).

Executive Capability: Production-grade hybrid sparse-dense memory retrieval engine combining BM25 keyword search, semantic n-gram cosine similarity, and recency decay ranking for agent episodic long-term memory.

⚡ Key Highlights

  • 🐍 Zero External pip Dependencies: Implemented entirely with pure Python standard library for instant zero-overhead execution.

  • 🔌 Native Model Context Protocol (MCP): Plugs directly into any MCP-compliant client via JSON-RPC 2.0 stdio.

  • ⚡ Sub-Millisecond Execution: Slashes token burn and latency by resolving routine agent tasks deterministically without frontier LLM round-trips.

  • 🛡️ Production-Hardened: Comprehensive error handling, boundary validation, and telemetry.


Related MCP server: vanguard-memory-node

🏗️ Architecture

graph LR
    Agent([🤖 Autonomous Agent / IDE]) -->|MCP Protocol / JSON-RPC| Server[⚡ genpark-agent-hybrid-memory-retriever-skill Server]
    Server --> Core[🧠 Deterministic Processing Core]
    Core --> Out[📊 Actionable Result & Telemetry]
    Out --> Agent

🚀 Quickstart & Usage

1. Direct Python Client Execution

python example_usage.py

2. Programmatic Integration

from client import AgentHybridMemoryRetriever

client = AgentHybridMemoryRetriever()
result = client.run_memory_benchmark()
print(result)

🔌 Model Context Protocol (MCP) Setup

Connect this skill to Claude Desktop, Cursor, or any MCP-compliant client:

claude_desktop_config.json

{
  "mcpServers": {
    "genpark-agent-hybrid-memory-retriever-skill": {
      "command": "python",
      "args": ["/path/to/genpark-agent-hybrid-memory-retriever-skill/mcp_server.py"]
    }
  }
}

Direct MCP Testing

python mcp_server.py --test

📊 Technical Specifications

Parameter

Type

Required

Description

payload

string / dict

Yes

Primary context, code, schema, or content input

options

dict

No

Execution flags, compression ratios, or risk bounds


Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      MCP-native persistent memory layer for AI agents across Claude Code, Cursor, VS Code, and OpenClaw. Powered by hybrid vector search, BM25, and cross-encoder reranking with a published 73.1% LoCoMo benchmark accuracy.
      4
      1
      Apache 2.0
    • A
      license
      A
      quality
      B
      maintenance
      Local deterministic BM25 memory for AI agents — offline-first, no API key, SHA-256 content-addressed shards, stdio MCP transport. Same query always returns the same ranked result.
      11
      51 npm
      MIT
    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables deterministic, zero-dependency long-horizon conversational memory compaction and episodic anchor extraction for AI agents, with native MCP protocol support and structured JSON telemetry output.
      -
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables agents to retrieve relevant context via a zero-dependency hybrid search engine that blends sparse keyword-based lexical ranking with dense vector similarity scores into one fused result set, then refines it with knowledge graph triplet expansion and lost-in-the-middle context reordering. It also provides episodic memory consolidation, recency decay, and semantic query caching, exposed as a JSON-RPC 2.0 stdio MCP server for clients such as Claude Desktop, Cursor, and Windsurf.
      MIT