MemCP - Memory Context Protocol for AI Agents

by evanmschultz

294 downloads
Not rated
GitHub

About

A memory MCP for IDE AI agent context support based on the mcp_server example by Zep AI

Details

Author
evanmschultz
Downloads
294
Categories
Knowledge Base

- Temporal knowledge graph that evolves with new information
- Automatic entity and relationship extraction
- Works with any MCP-compatible client
- Flexible configuration via env vars, TOML, or CLI
- Persists knowledge in Neo4j across sessions
- Supports both SSE and stdio transports

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MemCP - Memory Context Protocol for AI Agents
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install prerequisites (Python 3.10+, Neo4j 5.26+, OpenAI API key), clone the repository, install using uv sync or pip install memcp, copy and edit the .env file, then run memcp to start the server. For Cursor IDE, add a configuration block with "transport": "sse" and "url": "http://localhost:8000/sse" to the MCP servers settings.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "memcp - memory context protocol for ai agents": {
            "memcp": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

McpServers

{
    "memcp": {
        "command": "uv",
        "args": [
            "sync"
        ]
    }
}

MemCP - Memory Context Protocol for AI Agents

MemCP is an extensible memory MCP server for AI coding agents. It modularizes and extends the Zep AI Graphiti mcp-server example, allowing AI agents to build, maintain, and query a temporal knowledge graph of facts, entities, and relationships.

MemCP is currently designed as a plug and play memory server for any IDE or LLM client app that supports MCPs through local sse or stdio connections.

> Note: It has largely been tested with the Cursor IDE compared to other MCP capable clients.

Features

- Temporal Knowledge Graph: Lets your AI agents automatically build and query a temporal knowledge graph that evolves as new information is added.
- MCP Integration: Works with any MCP-compatible clients.
- Entity Extraction: Automatic entity and relationship extraction with coding specific entity types. Customization is on the roadmap.
- Flexible Configuration: Simple configuration via environment variables, TOML files, or CLI arguments
- Persistence: Stores knowledge in Neo4j for persistence across sessions
- Multiple Transports: Supports both SSE (HTTP) and stdio transports for integration with different clients

Documentation

Comprehensive documentation for MemCP can be found in the docs directory. See the docs README for an overview of available documentation.

Installation

Prerequisites

1. Python 3.10 or higher
2. Neo4j database (version 5.26 or later)
> Note: you can run it with docker if you do not want to install Neo4j locally.
3. OpenAI API key (required for embeddings)
4. Anthropic API key (optional, for Claude models)

Clone the repository

git clone https://github.com/evanmschultz/memcp.git
cd memcp

Using UV (Recommended)

UV is a fast package manager for Python written in Rust. Follow their docs for installation instructions if you don't have it already.

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.