membase mcp server

1# membase mcp server
2 
3## Description
4 
5Membase is the first decentralized memory layer for AI agents, powered by Unibase. It provides secure, persistent storage for conversation history, interaction records, and knowledge — ensuring agent continuity, personalization, and traceability.
6 
7The Membase-MCP Server enables seamless integration with the Membase protocol, allowing agents to upload and retrieve memory from the Unibase DA network for decentralized, verifiable storage.
8 
9## Functions
10 
11Messages or memoiries can be visit at: <https://testnet.hub.membase.io/>
12 
13- **get_conversation_id**: Get the current conversation id.
14- **switch_conversation**: Switch to a different conversation.
15- **save_message**: Save a message/memory into the current conversation.
16- **get_messages**: Get the last n messages from the current conversation.
17 
18## Installation
19 
20```shell
21git clone https://github.com/unibaseio/membase-mcp.git
22cd membase-mcp
23uv run src/membase_mcp/server.py
24```
25 
26## Environment variables
27 
28- MEMBASE_ACCOUNT: your account to upload
29- MEMBASE_CONVERSATION_ID: your conversation id, should be unique, will preload its history
30- MEMBASE_ID: your instance id
31 
32## Configuration on Claude/Windsurf/Cursor/Cline
33 
34```json
35{
36  "mcpServers": {
37    "membase": {
38      "command": "uv",
39      "args": [
40        "--directory",
41        "path/to/membase-mcp",
42        "run", 
43        "src/membase_mcp/server.py"
44      ],
45      "env": {
46        "MEMBASE_ACCOUNT": "your account, 0x...",
47        "MEMBASE_CONVERSATION_ID": "your conversation id, should be unique",
48        "MEMBASE_ID": "your sub account, any string"
49      }
50    }
51  }
52}
53```
54 
55## Usage
56 
57call functions in llm chat
58 
59- get conversation id and switch conversation
60 
61![get conversation id and switch conversation](./asset/switch.png)
62 
63- save message and get messages
64 
65![save message and get messages](./asset/save.png)
66