Store MCP Server
A Model Context Protocol (MCP) server that enables AI agents to store and retrieve information persistently.
Project Structure
Features
Store Information: Save key-value pairs or structured data
Retrieve Information: Query stored data by key or search criteria
List Keys: View all available stored keys
Delete Information: Remove stored data when no longer needed
Persistent Storage: Data persists across sessions
Installation
Usage
MCP Tools
The server exposes the following tools to AI agents:
store_data
: Store information with a keyretrieve_data
: Retrieve information by keylist_keys
: List all stored keysdelete_data
: Delete stored information by keysearch_data
: Search stored information by pattern or content
Configuration
MCP Client Configuration
To use this server with an MCP client (like Claude Desktop), add it to your MCP settings configuration file:
For Claude Desktop on MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
For Claude Desktop on Windows: %APPDATA%\Claude\claude_desktop_config.json
Alternative using uvx (if installed via pip):
Storage Configuration
The server uses a local file-based storage system (JSON) located at:
Default:
~/.store_mcp/data.json
To use a custom storage location, modify server.py
and initialize Storage with a custom path:
Environment Variables
You can set the following environment variables:
STORE_MCP_PATH
: Custom path for the storage file (default:~/.store_mcp/data.json
)
Example configuration with custom storage path:
Development
Requirements
Python 3.10+
mcp library
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
Enables AI agents to store and retrieve information persistently using key-value pairs with JSON file-based storage. Supports storing, retrieving, listing, deleting, and searching data across sessions.