You have a lightweight MCP server that stores and retrieves values using a simple in-memory key-value store. It exposes common operations like get, set, delete, list, and clear, and can be used by any MCP-compatible client to quickly experiment with data storage during a session.

How to use

Connect to the server using an MCP client via stdio transport. You can perform the core operations to store and retrieve data, inspect the current keys, and clear the store when you are done. The server automatically handles JSON values when you store data that looks like JSON, making it convenient to work with structured data. You can combine operations to build simple workflows, such as storing a user record, retrieving it later, listing all keys, and then cleaning up.

How to install

Prerequisites: Python 3.8+ and a working Python environment. You will install the package in development mode to run the MCP server locally.

Step by step commands to install and run the server locally:

# Step 1: Clone the repository
git clone https://github.com/jmgress/simple-mcp.git
cd simple-mcp

# Step 2: Install development dependencies
pip install -e .

---

Optional: Run tests (to verify the server)

python test_server.py

---

Run the MCP server (stdio transport)

simple-mcp-server

---

Or run directly with Python

python -m simple_mcp.server

Additional content

The server implements the following tools to interact with the store: get_value, set_value, delete_value, list_keys, clear_values, and get_store_info. Each tool operates on key-value data stored in memory for the duration of the session. The in-memory design makes it ideal for demonstrations and temporary data handling, with no persistence across restarts.

Available tools

get_value

Retrieve a value from the store by key.

set_value

Store a key-value pair in the store, with automatic JSON parsing if the value is valid JSON.

delete_value

Remove a key-value pair from the store.

list_keys

List all keys currently in the store.

clear_values

Clear all key-value pairs from the store.

get_store_info

Get information about the current state of the store.