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-2025.6.28.7206.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-2025.6.28.7206-py3-none-any.whl (21.2 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for memcp-2025.6.28.7206.tar.gz
Algorithm Hash digest
SHA256 023ad5abcecb38dd43ba5919be2e7aa3341a9df685f59fe1457e38638d831ba5
MD5 42e00af01af50e18525900e0bf507c95
BLAKE2b-256 e9cad7e780204eb011abcd2532ceff6e32ea9adc764a29cf88641274daa0dde0

See more details on using hashes here.

Provenance

The following attestation bundles were made for memcp-2025.6.28.7206.tar.gz:

Publisher: release.yml on moshez/memcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

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

File metadata

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

File hashes

Hashes for memcp-2025.6.28.7206-py3-none-any.whl
Algorithm Hash digest
SHA256 31eec658a3771a4076fe87da3c17937b052842a5bd01584e5b10c7f953c58f6a
MD5 fe1598e08e0896392625ca05bf5c9941
BLAKE2b-256 4008b0ad6415410957d70da4e25ddbf5b94f00a8bdec926712998c413f89be6c

See more details on using hashes here.

Provenance

The following attestation bundles were made for memcp-2025.6.28.7206-py3-none-any.whl:

Publisher: release.yml on moshez/memcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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