Context Portal MCP Server

A database-backed Model Context Protocol (MCP) server for managing structured project context, designed to be used by AI assistants and developer

Local serverstdioPython

What is the Context Portal MCP Server?

A database-backed Model Context Protocol (MCP) server for managing structured project context, designed to be used by AI assistants and developer tools within IDEs

The short version

Context Portal (ConPort) is your project's memory bank. It's a tool that helps AI assistants understand your specific software project better by storing important information like decisions, tasks, and architectural patterns in a structured way. Think of it as building a project-specific knowledge base that the AI can easily access and use to give you more accurate and helpful responses.

What it needs from you

Before you begin, ensure you have the following installed: - Python: Version 3.8 or higher is recommended. - Download Python - Ensure Python is added to your system's PATH during installation (especially on Windows). - uv: (Highly Recommended) A fast Python environment and package manager. Using uv significantly simplifies virtual environment

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_product_contextRetrieves the overall project goals, features, and architecture.
update_product_contextUpdates the product context. Accepts full content (object) or patch_content (object) for partial updates (use __DELETE__ as a value in patch to remove a key).
get_active_contextRetrieves the current working focus, recent changes, and open issues.
update_active_contextUpdates the active context. Accepts full content (object) or patch_content (object) for partial updates (use __DELETE__ as a value in patch to remove a key).
log_decisionLogs an architectural or implementation decision.
get_decisionsRetrieves logged decisions.
search_decisions_ftsFull-text search across decision fields (summary, rationale, details, tags).
delete_decision_by_idDeletes a decision by its ID.
log_progressLogs a progress entry or task status.
get_progressRetrieves progress entries.
update_progressUpdates an existing progress entry.
delete_progress_by_idDeletes a progress entry by its ID.
log_system_patternLogs or updates a system/coding pattern.

How to install the Context Portal MCP Server

{
  "mcpServers": {
    "conport": {
      "command": "uvx",
      "args": [
        "--from",
        "context-portal-mcp",
        "conport-mcp",
        "--mode",
        "stdio",
        "--workspace_id",
        "${workspaceFolder}",
        "--log-file",
        "./logs/conport.log",
        "--log-level",
        "INFO"
      ]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

Before you begin, ensure you have the following installed: - Python: Version 3.8 or higher is recommended. - Download Python - Ensure Python is added to your system's PATH during installation (especially on Windows). - uv: (Highly Recommended) A fast Python environment and package manager. Using uv significantly simplifies virtual environment

Example prompts to try

  • “Use Context Portal to get product context.”
  • “Use Context Portal to update product context.”
  • “Use Context Portal to get active context.”

Frequently asked questions

A database-backed Model Context Protocol (MCP) server for managing structured project context, designed to be used by AI assistants and developer tools within IDEs Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.