home / mcp / simple mcp server
simple-mcp
Configuration
View docs{
"mcpServers": {
"jmgress-simple-mcp": {
"command": "simple-mcp-server",
"args": []
}
}
}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.
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.
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)
```bash
python test_server.py
```
---
# Run the MCP server (stdio transport)
```bash
simple-mcp-server
```
---
# Or run directly with Python
```bash
python -m simple_mcp.serverThe 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.
Retrieve a value from the store by key.
Store a key-value pair in the store, with automatic JSON parsing if the value is valid JSON.
Remove a key-value pair from the store.
List all keys currently in the store.
Clear all key-value pairs from the store.
Get information about the current state of the store.