Mempro Client

MEMPRO客户端

MEMPRO V4 的 MCP 客户端 - 将Claude Desktop连接到Hetzner的中央内存后端。

🚀 快速开始

安装（Mac+Windows+Linux）

# Einmalig - keine weitere Installation notwendig!
npx -y mempro-client

Claude 桌面配置

Mac/Linux (~/.claude.json):

{
  "mcpServers": {
    "mempro": {
      "command": "npx",
      "args": ["-y", "mempro-client"]
    }
  }
}

视窗 (%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "mempro": {
      "command": "npx",
      "args": ["-y", "mempro-client"]
    }
  }
}

重新启动 Claude

1. 完全关闭 Claude Desktop
2. 重新启动
3. ✅ MCP工具应该可用

🎯 可用工具

mempro_health()

后端健康检查

{
  "status": "ok",
  "backends": {
    "openmemory": "ok",
    "zep": "ok",
    "lightrag": "ok",
    "pieces": "disabled"
  }
}

mempro_add(text, user_id?)

存储内存（并行 OpenMemory + Zep）

例如：

Speichere: "MEMPRO V4 läuft auf Hetzner mit OpenMemory, Zep und LightRAG"

退货：

{
  "openmemory": {
    "id": "uuid-...",
    "sectors": ["semantic"],
    "chunks": 1
  },
  "zep": {
    "uuid": "uuid-...",
    "content": "...",
    "created_at": "2025-11-18T..."
  },
  "status": "ok"
}

mempro_query(query, user_id?)

查询内存（OpenMemory + Zep组合）

例如：

Frage: "Was läuft auf Hetzner?"

退货：

{
  "openmemory": [
    {
      "id": "...",
      "content": "MEMPRO V4 läuft auf Hetzner...",
      "score": 0.95,
      "source": "openmemory"
    }
  ],
  "zep": [
    {
      "edges": [...]
    }
  ],
  "combined": [...]
}

mempro_search(query, user_id?, top_k?)

矢量搜索（多后端）

例如：

Suche: "Hetzner Server", top_k=3

退货：

{
  "results": [
    {
      "id": "...",
      "content": "...",
      "score": 0.998,
      "source": "openmemory"
    }
  ]
}

🏗️ 建筑

┌──────────────────────────────────────┐
│   HETZNER (135.181.128.98:8821)      │
│                                      │
│   MEMPRO V4 Backend                  │
│   ├─ OpenMemory (lokal HSG)          │
│   ├─ LightRAG (lokal KG)             │
│   └─ Zep Cloud (Graphiti v3)         │
└─────────────┬────────────────────────┘
              │
        HTTP API
              │
    ┌─────────┼─────────┬─────────┐
    │         │         │         │
┌───▼────┐ ┌─▼──────┐ ┌▼───────┐ ┌▼──────┐
│Mac     │ │Windows │ │Linux   │ │  ...  │
│        │ │  PC    │ │  PC    │ │       │
│MCP     │ │MCP     │ │MCP     │ │MCP    │
│Client  │ │Client  │ │Client  │ │Client │
└────────┘ └────────┘ └────────┘ └───────┘

不要在任何PC上安装！

• ✅ Hetzner的中心数据
• ✅ 无需同步
• ✅ 所有平台的一个命令

🔧 高级配置

自定义后端URL

{
  "mcpServers": {
    "mempro": {
      "command": "npx",
      "args": ["-y", "mempro-client"],
      "env": {
        "MEMPRO_URL": "https://custom-mempro.example.com"
      }
    }
  }
}

多用户设置

{
  "mcpServers": {
    "mempro-mac": {
      "command": "npx",
      "args": ["-y", "mempro-client"],
      "env": {
        "DEFAULT_USER": "thorsten-mac"
      }
    }
  }
}

📊 系统要求

• Node.js: >= 18.0.0
• 网络访问 Hetzner 服务器 （135.181.128.98:8821）
• 克劳德桌面支持 MCP 的任何版本

🆘 故障排除

工具不可用

1. 完全关闭并重新启动 Claude
2. 检查配置文件（JSON有效吗？）
3. 打开终端： npx -y mempro-client （应该等待，而不是崩溃）

连接被拒绝

# Test vom PC:
curl http://135.181.128.98:8821/healthz
# Sollte: {"status":"ok","backends":{...}}

如果没有：

• 检查防火墙规则
• 检查 VPN/网络配置
• 后端运行？ （查看Hetzner）

NPX LäDT尤因

# Alternative: Globale Installation
npm install -g mempro-client

# Dann in Config:
"command": "mempro-client"

📝 发展

# Clone repo
git clone https://github.com/thorsten-secstack/mempro-client.git
cd mempro-client

# Install deps
npm install

# Test lokal
node index.js
# (wartet auf stdin - Ctrl+C zum Beenden)

📄 许可证

麻省理工学院许可证-版权所有（c）2025 Thorsten SecStack

🔗 链接

• 后端MEMPRO V4 在 Hetzner
• 仪表盘: http://135.181.128.98:8821/status
• 健康: http://135.181.128.98:8821/healthz

______________________________________________________________________

由以下材料制成❤️ 用于集中式内存编排