Skip to main content
Glama
genpark-cosine-bm25-reciprocal-rank-fusion-skill

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

by Alpha-Park

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: Strata

πŸ—οΈ 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

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
      Persistent memory MCP server for AI coding agents (Claude Code, Codex, Gemini CLI). Hybrid retrieval (vector + BM25), cross-encoder reranking, knowledge graph, session checkpoint/resume, and multi-scope isolation. Local-first with LanceDB.
      30
      48 npm
      15
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Local-first memory layer for AI agents. Compresses context with a local LLM and serves hybrid search over MCP.
      775 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables agents to optimize context-window attention by reordering retrieved documents so critical evidence lands at prompt boundaries, mitigating lost-in-the-middle degradation. It combines BM25 lexical scoring, dense vector similarity, reciprocal rank fusion, knowledge-graph expansion, and recency-decay memory caching, exposed as a zero-dependency MCP stdio server.
      7
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Gives every AI agent a shared, persistent memory by ingesting Obsidian vaults, code, transcripts, bookmarks and terminal sessions into a three-tier SQLite FTS5 store, then serving token-optimized hybrid retrieval, classification, promotion and cross-source synthesis over MCP and REST. This lets multiple agents read from and write to one compounding brain so each session starts with better context than the last.
      10 npm
      MIT