
Fusionpact Vectordb
io.github.atul-fusionpactPublished by GitHub account atul-fusionpactv2.1.1Updated Oct 24, 2026
Hybrid vector + reasoning retrieval, agent memory, multi-agent orchestration, MCP server, and RAG.
Overview
Local MCP server exposing FusionPact's hybrid vector, tree and keyword retrieval, RAG ingestion and agent memory tools to an AI assistant.
- What you can do
- Create and manage HNSW vector collections and run semantic vector search
- Run hybrid retrieval that fuses vector, tree-reasoning and keyword results
- Ingest documents into a RAG pipeline and build LLM-ready context with citations
- Store, recall, learn and share agent memories across episodic, semantic, procedural and shared pools
- Manage conversation threads and erase memories on request
- When to use it
- Useful when an assistant should keep persistent memory across sessions or answer questions over your own documents with hybrid retrieval and citations, all running locally without a hosted vector database.
- Requirements
- Runs as a local process via npx fusionpact mcp, so Node.js and npm are needed. The EMBEDDING_PROVIDER environment variable selects ollama (needs a local Ollama instance and an embedding model), openai (needs an OpenAI API key) or mock for testing. Tree reasoning optionally uses a local LLM provider.
Installation
In SourceWeft
- Open Fusionpact Vectordb in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
⚡ FusionPact
The Agent-Native Retrieval Engine
Hybrid Vector + Reasoning + Memory for AI Agents
Similarity ≠ Relevance. FusionPact is the first retrieval engine that combines HNSW vector search, reasoning-based tree retrieval, and agent memory in a single platform — purpose-built for AI agents and multi-agent systems.
Quickstart · Hybrid Retrieval · Agent Memory · Multi-Agent · MCP Server · Tree Index · RAG Pipeline · API Reference · Benchmarks · Contributing
Why FusionPact?
Traditional vector databases retrieve what's similar. But similar ≠ relevant. Ask a vector DB for "Q3 2024 revenue" and you might get Q2 or Q4 data — semantically similar, but the wrong answer.
FusionPact solves this by combining three retrieval paradigms:
Plus purpose-built agent memory, multi-agent orchestration, and MCP server — all zero-dependency, local-first, and free.
⚡ Quickstart
10 Lines of Code
🔀 Hybrid Retrieval Engine
The core differentiator: a single API that intelligently routes queries through multiple retrieval strategies and fuses results using Reciprocal Rank Fusion.
Strategy Weights
Adaptive Learning
FusionPact learns which retrieval strategy works best for different query patterns:
🌲 Tree Index
Reasoning-based retrieval for structured documents. Builds a hierarchical tree (like an intelligent table of contents) and uses LLM reasoning to navigate to the most relevant sections.
Works Without LLM Too
If no LLM provider is configured, TreeIndex falls back to keyword-based tree traversal — still useful, just without the reasoning path:
🧠 Agent Memory
Purpose-built memory system for AI agents with four memory types:
🤖 Multi-Agent Orchestration
Coordinate multiple AI agents with isolated memory, shared knowledge, and message routing:
🔌 MCP Server
FusionPact ships as an MCP (Model Context Protocol) server. Any AI agent (Claude, Cursor, Windsurf) can use it as persistent memory — no custom integration needed.
Claude Desktop Setup
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
Available MCP Tools
📄 RAG Pipeline
End-to-end RAG in one call:
Chunking Strategies
🔒 Multi-Tenancy
Zero-trust soft-isolation — tenants can never see each other's data:
🔌 Embedding Providers
📊 Benchmarks
HNSW Performance (128D vectors)
Run your own:
🆚 Comparison
📖 API Reference
Full documentation: docs/API.md
Core Classes
🗺 Roadmap
- HNSW indexing with configurable M/ef parameters
- Multi-tenancy with soft-isolation
- One-Click RAG pipeline
- Agent Memory (episodic, semantic, procedural, shared)
- Multi-agent orchestration
- Tree Index (reasoning-based retrieval)
- Hybrid Retriever (vector + tree + keyword fusion)
- MCP server (stdio + HTTP)
- HTTP API server
- Ollama + OpenAI embedding providers
- Adaptive retrieval learning
- SQLite/PostgreSQL persistence
- Python SDK (
pip install fusionpact) - LangChain integration
- LlamaIndex integration
- CrewAI / AutoGen integration
- Vision RAG (PDF page images)
- Rust core (NAPI bindings)
- FusionPact Cloud (managed hosting)
- Dashboard UI
🤝 Contributing
We welcome contributions! See CONTRIBUTING.md for guidelines.
📜 Attribution
FusionPact is built and maintained by FusionPact Technologies Inc.
If you use FusionPact in your project, please include attribution in one of the following ways:
- Include "Powered by FusionPact" in your application's about page or documentation
- Keep the
NOTICEfile in your distribution - Reference FusionPact Technologies Inc. in your project's acknowledgements
See ATTRIBUTION.md for full details.
License
Apache 2.0 — Use freely in commercial and open-source projects.
The Apache 2.0 license requires that you:
- Include a copy of the license in any redistribution
- Include the NOTICE file with attribution to FusionPact Technologies Inc.
- State any significant changes you made to the code
Built with ❤️ by FusionPact Technologies Inc.
⭐ Star this repo if you find it useful!
Source: README.md at commit 1233b44
Tools
0Version history
1- v2.1.1LatestSep 16, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts