Membase Mcp

What is Membase Mcp about?

Membase Mcp enables AI agents to store and retrieve conversation history, interaction records, and knowledge on the Unibase decentralized network. It acts as a bridge between agents and the Membase protocol, ensuring data persistence, traceability, and verification across sessions.

How to use Membase Mcp?

1. Clone the repository and start the server:

   git clone https://github.com/unibaseio/membase-mcp.git
   cd membase-mcp
   uv run src/membase_mcp/server.py
   

2. Set the required environment variables (MEMBASE_ACCOUNT, MEMBASE_CONVERSATION_ID, MEMBASE_ID).
3. From an LLM chat interface, call the exposed functions:
   • get_conversation_id
   • switch_conversation
   • save_message
   • get_messages The functions interact with the running MCP server to manage memory for the current conversation.

Key Features of Membase Mcp

• Decentralized, verifiable storage of AI memory on the Unibase network.
• Multi‑session conversation handling with unique conversation IDs.
• Simple function calls (get_conversation_id, switch_conversation, save_message, get_messages).
• Supports environment‑based configuration for flexible deployment.
• Accessible via a web interface for testing: https://testnet.hub.membase.io/

Use Cases of Membase Mcp

• Maintaining long‑term context for assistants that need to remember past interactions.
• Personalization of AI agents by persisting user preferences and history.
• Auditable AI workflows where each message is stored on a tamper‑evident ledger.
• Cross‑session collaboration between multiple agents sharing a common memory store.

FAQ from the Membase Mcp

Q: Do I need a blockchain node to run the server? A: No. The server uses the Unibase DA network via the Membase protocol; you only need an account and appropriate environment variables.

Q: Can I change the conversation ID at runtime? A: Yes, use the switch_conversation function to load a different conversation ID and its history.

Q: What format are messages stored in? A: Messages are stored as raw strings in the Membase network and can be retrieved as a list of the most recent n entries.

Q: Is the memory encrypted? A: Data is secured by the underlying Unibase protocol, which provides cryptographic verification and integrity.

Q: How do I integrate with Claude, Windsurf, Cursor, or Cline? A: Add the JSON snippet from the README to the respective model’s configuration, providing the same environment variables.

membase mcp server

Description

Membase 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.

The 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.

Functions

Messages or memoiries can be visit at: https://testnet.hub.membase.io/

• get_conversation_id: Get the current conversation id.
• switch_conversation: Switch to a different conversation.
• save_message: Save a message/memory into the current conversation.
• get_messages: Get the last n messages from the current conversation.

Installation

git clone https://github.com/unibaseio/membase-mcp.git
cd membase-mcp
uv run src/membase_mcp/server.py

Environment variables

• MEMBASE_ACCOUNT: your account to upload
• MEMBASE_CONVERSATION_ID: your conversation id, should be unique, will preload its history
• MEMBASE_ID: your instance id

Configuration on Claude/Windsurf/Cursor/Cline

{
  "mcpServers": {
    "membase": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/membase-mcp",
        "run", 
        "src/membase_mcp/server.py"
      ],
      "env": {
        "MEMBASE_ACCOUNT": "your account, 0x...",
        "MEMBASE_CONVERSATION_ID": "your conversation id, should be unique",
        "MEMBASE_ID": "your sub account, any string"
      }
    }
  }
}

Usage

call functions in llm chat

• get conversation id and switch conversation

• save message and get messages