Skip to main content

Memory for Model Context Protocol

Project description

Documentation Status PyPI version Python versions

memcp is a Model Context Protocol (MCP) server that provides persistent memory capabilities for AI assistants like Claude. It enables storing and retrieving information across conversations using a local SQLite database.

Features

  • Persistent Storage: Store information that persists between conversations

  • Keyword-Based Search: Efficiently find stored memories using keyword associations

  • Simple Key-Value Store: Easy to use get/set operations with additional keyword metadata

  • Local SQLite Database: All data stored locally in a SQLite database you control

  • MCP Integration: Seamlessly integrates with Claude Desktop and other MCP clients

Installation

Install from PyPI:

pip install memcp

Or install from source:

git clone https://github.com/moshez/memcp.git
cd memcp
pip install -e .

Quick Start

Configure memcp in Claude Desktop by adding it to your claude_desktop_config.json:

{
  "mcpServers": {
    "memcp": {
      "command": "/path/to/python",
      "args": ["-m", "memcp", "--db", "/path/to/memory.db"]
    }
  }
}

See the full documentation for detailed configuration instructions.

Documentation

Full documentation is available at memcp.readthedocs.io.

Development

To set up a development environment:

# Clone the repository
git clone https://github.com/moshez/memcp.git
cd memcp

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install in development mode
pip install -e .

# Install development dependencies
pip install nox

# Run tests
nox -e tests

# Run linting
nox -e lint

# Build documentation
nox -e docs

License

MIT License - see LICENSE file for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

memcp-2022.3.6.2.tar.gz (18.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

memcp-2022.3.6.2-py3-none-any.whl (21.2 kB view details)

Uploaded Python 3

File details

Details for the file memcp-2022.3.6.2.tar.gz.

File metadata

  • Download URL: memcp-2022.3.6.2.tar.gz
  • Upload date:
  • Size: 18.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.1

File hashes

Hashes for memcp-2022.3.6.2.tar.gz
Algorithm Hash digest
SHA256 1b67bf8f6abca8cddcfa8aa6c2e41d2fe2b07b86b7ed0a2497e1c5fbd0328d8e
MD5 ab4fa05ef9836a1e1f9a383234d77b61
BLAKE2b-256 4bda1d8a9ecea24dd66b573b4dd69c46627360874a64382173dc2c48b3ed32ec

See more details on using hashes here.

File details

Details for the file memcp-2022.3.6.2-py3-none-any.whl.

File metadata

  • Download URL: memcp-2022.3.6.2-py3-none-any.whl
  • Upload date:
  • Size: 21.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.1

File hashes

Hashes for memcp-2022.3.6.2-py3-none-any.whl
Algorithm Hash digest
SHA256 e5f230205b41b6ff1d7c46b14f273a88441c921685737a6979165a8f39c245ad
MD5 b9034c2a425112a3a9d0379cb3f8d0f2
BLAKE2b-256 34bb631f9c18c3b16083c65e12cf50eaaa7a2d540745b082e69d177d138d5db9

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page