Store

A very simple K/V store MCP

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mariano-cecowski-store_mcp": {
      "command": "python",
      "args": [
        "-m",
        "store_mcp.server"
      ],
      "env": {
        "PYTHONPATH": "/absolute/path/to/store_mcp/src",
        "STORE_MCP_PATH": "/custom/path/to/storage.json"
      }
    }
  }
}

You can store, retrieve, and manage persistent information with the Store MCP Server. It lets AI agents save key-value data or structured data, search it, list keys, and delete items, all with data persisting across sessions.

How to use

You interact with the Store MCP Server through an MCP client. Start the server locally, then configure your MCP client to point to it so you can store and retrieve data during conversations. Use the available tools to: save information with a key, fetch data by key, list all stored keys, delete data by key, and search your stored data by pattern or content.

How to install

Prerequisites: Python 3.10 or newer and an MCP client environment to interact with the server.

Install the server in editable mode to install dependencies and make development changes easy.

pip install -e .

Run the MCP server using Python’s module entry point.

python -m store_mcp.server

Configuration and usage notes

The server uses a local file-based storage system. By default, data is stored at ~/.store_mcp/data.json. You can customize the storage path by initializing Storage with a different path in your code.

Environment variables you may configure for running the server include the following.

Development

Run tests to verify the server behavior.

pytest tests/

Available tools

store_data

Store information with a key, supporting either a simple key-value pair or structured data for persistence across sessions.

retrieve_data

Retrieve information by key to access stored data quickly.

list_keys

List all stored keys currently available in the storage backend.

delete_data

Remove stored information by key to free up storage.

search_data

Search stored information by pattern or content to locate relevant data.