evangstav_python-memory-mcp-server

Memory MCP Server

An implementation of the Model Context Protocol (MCP) server for managing Claude's memory and knowledge graph.

Installation

You can install the package using uv:

uvx memory-mcp-server

Or install it from the repository:

uv pip install git+https://github.com/estav/python-memory-mcp-server.git

Usage

Once installed, you can run the server using:

uvx memory-mcp-server

Configuration

The server expects certain environment variables to be set:

• DATABASE_URL: SQLite database URL for storing the knowledge graph
• Add any other configuration variables here...

Integration with Claude Desktop

To use this MCP server with Claude Desktop, add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "memory": {
      "command": "uvx",
      "args": ["memory-mcp-server"]
    }
  }
}

Development

1. Clone the repository:

git clone https://github.com/estav/python-memory-mcp-server.git
cd python-memory-mcp-server

2. Create a virtual environment and install dependencies:

uv venv
source .venv/bin/activate
uv pip install -e ".[test]"  # Include test dependencies

3. Run tests:

pytest                    # Run all tests
pytest -v                # Run with verbose output
pytest -v --cov         # Run with coverage report

4. Run the server locally:

python -m memory_mcp_server

Testing

The project uses pytest for testing. The test suite includes:

Unit Tests

• test_knowledge_graph_manager.py: Tests for basic knowledge graph operations
• test_optimized_knowledge_graph_manager.py: Tests for optimized/batch operations
• test_server.py: Tests for MCP server implementation

Running Tests

# Run all tests
pytest

# Run with coverage report
pytest --cov=memory_mcp_server

# Run specific test file
pytest tests/test_server.py

# Run tests with verbose output
pytest -v

Test Fixtures

The conftest.py file provides common test fixtures:

• temp_db_path: Creates a temporary SQLite database
• knowledge_graph_manager: Provides a KnowledgeGraphManager instance
• optimized_knowledge_graph_manager: Provides an OptimizedKnowledgeGraphManager instance

License

This project is licensed under the MIT License - see the LICENSE file for details.