Skip to main content
Glama
alphaparkinc

genpark-cosine-bm25-reciprocal-rank-fusion-skill

Official

genpark-cosine-bm25-reciprocal-rank-fusion-skill

Python 3.9+ License MIT MCP Compatible GenPark AI Zero Dependencies


⚡ Overview & Architectural Significance

genpark-cosine-bm25-reciprocal-rank-fusion-skill delivers zero-dependency, low-latency, deterministic agentic memory and retrieval primitives engineered strictly using Python 3.9+ standard library.

🌟 Key Architectural Capabilities

  • Zero External Dependencies: Operates exclusively via pure Python (math, re, collections, heapq, hashlib, json). Zero pip install overhead, zero C-extension compile errors.

  • Enterprise RAG & Memory Invariants: Implements formal algorithms for cognitive decay, BM25 Okapi lexical scoring, Reciprocal Rank Fusion, knowledge graph traversal, semantic query caching, and lost-in-the-middle context reordering.

  • Native Anthropic MCP Protocol: Compliant with standard JSON-RPC 2.0 stdio MCP specifications for Claude Desktop, Cursor, and Windsurf.


Related MCP server: genpark-agent-hierarchical-episodic-memory-skill

🏗️ Architectural Topology & State Machine

flowchart TD
    UserQuery["User Prompt / Agent Goal"] --> SemCache["Semantic Cache Check"]
    SemCache -->|Cache Hit| FastReturn["Cached Response (0ms)"]
    SemCache -->|Cache Miss| DualRetrieval["Dual Retrieval Pipeline"]
    
    subgraph DualRetrieval ["Hybrid Search Engine"]
        BM25Lex["BM25 Okapi Lexical Ranker"]
        DenseVec["Dense Cosine Vector Similarity"]
    end
    
    DualRetrieval --> RRF["Reciprocal Rank Fusion (RRF)"]
    RRF --> GraphExp["Knowledge Graph Triplet Expansion"]
    GraphExp --> LostMiddle["Lost-In-The-Middle Context Reorderer"]
    LostMiddle --> LLM["LLM Synthesis with Optimal Context"]
    LLM --> EpisodicMem["Episodic Consolidation & Recency Decay"]

🚀 Quickstart & Standalone Execution

Local Python Client Usage

from client import CosineBM25ReciprocalRankFusion

# Initialize engine
engine = CosineBM25ReciprocalRankFusion()

# Execute self-testing benchmark suite
result = engine.run_benchmark_rrf_fusion()
print("Execution Result:", result)

🔌 One-Click MCP Integration (Claude Desktop / Cursor)

Add to your claude_desktop_config.json or cursor.json:

{
  "mcpServers": {
    "genpark-cosine-bm25-reciprocal-rank-fusion-skill": {
      "command": "python",
      "args": ["-u", "/path/to/genpark-cosine-bm25-reciprocal-rank-fusion-skill/mcp_server.py"]
    }
  }
}

📦 Smithery.ai & PyPI Deployment

This skill contains pre-configured smithery.yaml and pyproject.toml manifests. Install directly via pip:

pip install git+https://github.com/alphaparkinc/genpark-cosine-bm25-reciprocal-rank-fusion-skill.git

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    B
    maintenance
    Enables deterministic hybrid ranking by fusing dense, sparse, and BM25 retrieval results with reranking and Reciprocal Rank Fusion, producing structured output via MCP for AI agents.
    8
    -
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables agents to maintain multi-tier memory across working scratchpad, dialogue buffer, and episodic stores with recency decay. Supports hybrid BM25/vector retrieval, rank fusion, graph expansion, and context reordering for optimized MCP-based memory and RAG workflows.
    7
    MIT
  • A
    license
    Not graded
    quality
    B
    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.
    7
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables agents to build and query structured semantic graphs, extracting, traversing and multi-hop reasoning over entity-relation-object triples while producing Cypher and JSON-LD graph output. It also combines BM25 lexical and dense vector retrieval with rank fusion, semantic caching and context reordering for grounded agentic memory.
    7
    MIT