context-portal

context-portal

Database-backed MCP server for managing structured project context and knowledge graphs.

690
Stars
72
Forks
2
Releases

Overview

Context Portal MCP (ConPort) is a memory-bank backend that stores structured project context in a per-workspace SQLite database and exposes an MCP API built with Python and FastAPI. It serves AI assistants and developer tools by enabling storage, retrieval, and management of diverse project data—decisions, progress, architecture, glossaries, specs, and other custom data—connected as a project knowledge graph with explicit relationships. The system uses vector embeddings for semantic search to support Retrieval Augmented Generation (RAG) and more accurate information access. It supports multi-workspace workflows via workspace_id, with a primary STDIO deployment mode designed for tight IDE integration. The server provides a comprehensive set of MCP tools for interacting with the graph, including product context, active context, decisions, progress, system patterns, and custom data, plus facilities for linking items and exporting/importing data. Database migrations are managed via Alembic to ensure safe schema evolution. ConPort replaces file-based memory with a robust, queryable backend, and is designed to be IDE- and client-agnostic, usable from various MCP clients that support workspace-based operation. It includes setup guidance for local development and LLM strategy integrations.

Details

Owner
GreatScottyMac
Language
Python
License
Apache License 2.0
Updated
2025-12-07

Features

Structured SQLite storage

One SQLite database per workspace, automatically created to store structured project context (decisions, progress, architecture) in a clean, queryable backend.

MCP server built with Python/FastAPI

Exposes the ConPort MCP API and a comprehensive set of tools for interacting with the project knowledge graph.

Multi-workspace support via workspace_id

Isolates data per workspace so multiple projects can be managed concurrently within the same ConPort instance.

Primary STDIO deployment mode

Optimized for tight IDE integration, enabling streamlined development workflows and tool interactions.

Project knowledge graph with explicit relationships

Builds and queries relationships between context items to form a dynamic, queryable knowledge graph.

Vector data storage and semantic search

Stores embeddings and provides semantic search capabilities to power context retrieval and RAG workflows.

RAG backend for precise memory access

Serves as a robust backend for Retrieval Augmented Generation, delivering accurate, up-to-date project memory to AI agents.

Alembic migrations for schema evolution

Manages database schema changes safely across versions to maintain data integrity.

Audience

AI assistantsAccess per-project memory and knowledge graph to provide context-aware, accurate responses powered by ConPort.
IDE developersIntegrate ConPort into IDEs and client tools to manage and query workspace-specific project context.
Project teamsCollaborate on decisions, progress, and architecture using a structured knowledge graph.

Tags

ConPortContext PortalMCPmemory-bankproject-knowledge-graphSQLitevector-embeddingssemantic-searchRAGSTDIOAlembic-migrationsmulti-workspaceIDE-integration