powermem-mcp 0.1.0

PowerMem MCP Server - Model Context Protocol server for PowerMem memory management

PowerMem MCP Server

PowerMem MCP Server - Model Context Protocol server for PowerMem memory management.

English | 简体中文

Prerequisites

Before using the PowerMem MCP Server, please ensure:

1. PowerMem is installed: The server requires PowerMem to be installed. You can install it via:

   pip install powermem
   

2. Configuration file exists: Create a .env file in your working directory or project root with PowerMem configuration. The server will automatically search for .env files in:

   • Current working directory's .env
   • Project root directory's .env
   • examples/configs/.env

   You can copy the .env.example file as a template:

   cp powermem_mcp/.env.example .env
   

   Then edit the .env file and configure the following key settings:

   • Database Provider: Choose from sqlite, oceanbase, or postgres
   • LLM Provider: Choose from qwen, openai, or mock
   • Embedding Provider: Choose from qwen, openai, or mock
   • API Keys: Set your LLM and Embedding API keys
   • Agent Configuration: Configure memory management settings
   • Intelligent Memory: Enable/configure Ebbinghaus forgetting curve settings
   • Performance: Adjust batch sizes, cache settings, and search parameters
   • Security: Configure encryption and access control
   • Logging: Set logging levels and file paths

   The .env.example file contains detailed comments and example configurations for different use cases.

For PowerMem installation and configuration, please refer to:

PowerMem Documentation

Startup

Support for multiple types of MCP

You can start PowerMem MCP with different protocols using the following commands:

uvx powermem-mcp sse # sse mode, default port 8000 (recommended)
uvx powermem-mcp stdio # stdio mode
uvx powermem-mcp sse 8001 # sse mode, specify port 8001
uvx powermem-mcp streamable-http # streamable-http mode, default port 8000
uvx powermem-mcp streamable-http 8001 # streamable-http mode, specify port 8001

Usage

Use with MCP Client, must use a client that supports Prompts, such as: Claude Desktop. Before entering a request, you need to manually select the required Prompt, then enter the request.

Claude Desktop config example:

{
  "mcpServers": {
    "powermem": {
      "url": "http://{host}:8000/mcp"
    }
  }
}

Available Tools

The PowerMem MCP Server provides the following memory management tools:

• add_memory: Add new memory to storage. Supports string, message dict, or message list format. Can use intelligent mode for automatic inference.
• search_memories: Search memories by query text with optional filters, limit, and similarity threshold.
• get_memory_by_id: Get a specific memory by its ID.
• update_memory: Update the content and metadata of an existing memory.
• delete_memory: Delete a specific memory by its ID.
• delete_all_memories: Batch delete memories by user_id, agent_id, or run_id.
• list_memories: List all memories with pagination support (limit and offset) and optional filters.

Community

When you need help, you can find developers and other community partners at https://github.com/oceanbase/powermem.

When you discover project defects, please create a new issue on the issues page.

License

For more information, see LICENSE.