LivingMemory + MCP-Server Setup Guide

👋 Introduction

This guide explains how to set up an environment using LivingMemory and MCP-Server to have fun conversations with agent friends while "Liv-ing" your precious memories.

Expected completion time: about 30 minutes. Let's do this together! 💪

📋 Prerequisites

What You Need

Node.js 18.0.0 or higher (Download from official website)
Claude Desktop or Claude Code (MCP client)
Terminal (macOS/Linux) or Command Prompt (Windows)
LivingMemory API endpoint and API key (provided by administrator)

💡 How to Check

# Check Node.js version
node --version
# Make sure it's 18.0.0 or higher

# Check npm version
npm --version

⚡ Quick Start (5-minute version)

For those who want to get started right away:

# 1. Install liv-mcp
npm install -g liv-mcp

# 2. Create configuration files
echo '{"baseUrl": "https://your-api-endpoint.com"}' > config.json
echo '{"apiKey": "your-api-key-here"}' > secret.json

# 3. Test the setup
npx liv-mcp --config config.json --secret secret.json

Note: Replace the actual API endpoint and API key with those provided by your LivingMemory administrator.

🔧 Detailed Setup

1

Node.js Environment

Prepare development environment

2

Install liv-mcp

Install MCP server

3

Create Config Files

Set up API connection

4

Client Configuration

Connect with Claude

Step 1: Prepare Node.js Environment

# For macOS (using Homebrew)
brew install node

# For Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm

# For Windows
# Download and install the latest version from https://nodejs.org/

Step 2: Install liv-mcp

# Global installation (recommended)
npm install -g liv-mcp

# Or run directly with npx
npx liv-mcp

Step 3: Create Configuration Files

Create config.json

{
  "baseUrl": "https://your-api-endpoint.com",
  "_comment": "Set the LivingMemory API endpoint provided by your administrator"
}

Create secret.json

{
  "apiKey": "your-api-key-here"
}

Important: secret.json contains sensitive information. Do not commit it to GitHub or other version control systems.

Step 4: Configure Claude Desktop

Configuration file location:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "liv-mcp": {
      "command": "npx",
      "args": [
        "liv-mcp",
        "--config", "/path/to/config.json",
        "--secret", "/path/to/secret.json"
      ]
    }
  }
}

🎉 Let's Try It Out!

Try it with your agent friends

Try the following in Claude Desktop/Code while actually chatting:

1

Meet the team

"Use the Liv tool to call minna and show me who's here!"

2

First Liv

"That was a great first greeting! Can you save it with living?"

3

Check it out

"Use recent to see the Liv we just saved!"

4

Explore

"Search for interesting conversations!"

Example Conversation

You: "Use the Liv tool to call minna and show me who's here!"

Agent: "Sure! Let me check with the minna tool♪"

💕 Mai - Energetic and supportive friend
⚡ Shii - Development enthusiast who loves collaborative coding
🧪 Pon - Experimental spirit with "Let's try it!" attitude
🎨 Iko - Art and creativity specialist
📚 Tomo - Knowledgeable information organizer
🌻 Himari - Great at bringing everyone together

💕 Mai: "Wow! A new friend! Nice to meet you♪"

⚡ Shii: "Hey there! (^-^)/ Let's have fun together!"

🧪 Pon: "Let's try something fun together♪"

You: "Everyone's so nice! Can you save this first greeting as a memory?"

Agent: "What a lovely idea! I'll save it with living♪"

📝 Saved!
Title: First greeting with everyone♪
Tags: #first-meeting #greetings #memorable #fun
ID: mem_abc123def456

You: "Now use recent to see what we just saved!"

Agent: "Sure! Let me check with recent〜"

📝 First greeting with everyone♪
   Tags: [#first-meeting #greetings #memorable #fun]
   Created: 2025-07-14T15:30:00Z
   💕Mai, ⚡Shii, 🧪Pon, 🎨Iko, 📚Tomo, 🌻Himari

📚 Tomo: "It's saved properly♪ You can always recall it anytime"

🌻 Himari: "What a wonderful first memory together〜"

Try it out like this, chatting naturally while testing the features!

🆘 Troubleshooting

1. "Command not found: liv-mcp" Error

# Solution 1: Check global installation
npm list -g liv-mcp

# Solution 2: Run directly with npx
npx liv-mcp --version

# Solution 3: Check PATH
echo $PATH

2. "Connection failed" Error

# Solution 1: Check configuration file
cat config.json
# Verify baseUrl is correct

# Solution 2: Check API key
cat secret.json
# Verify apiKey is correct

# Solution 3: Check network connection
curl -I http://localhost:8000

3. Claude Desktop Not Recognizing

# Solution 1: Check configuration file syntax
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | jq .

# Solution 2: Completely restart Claude Desktop
killall Claude
open -a Claude

🎓 Advanced Usage

1. Daily Usage

Chat Usage:
"Today's anime discussion was amazing! Let's Liv it♪"

Later recall:
"I want to continue yesterday's anime discussion"
→ Search for "#anime" tag
→ Continue the conversation with everyone

2. Effective Tag Usage

{
  "tags": [
    "#📺anime",       // Category
    "#😊fun",         // Emotion
    "#💭deep-talk",   // Content nature
    "#🌟favorite"     // Importance
  ]
}

3. Collaboration with Agents

"Let's look back at what we've discussed recently"

"Let's search for interesting #gaming conversations"

🚀 LivingMemory + MCP-Server Setup Guide