MEMPRO客户端
MEMPRO V4 的 MCP 客户端 - 将Claude Desktop连接到Hetzner的中央内存后端。
🚀 快速开始
安装(Mac+Windows+Linux)```bash
Einmalig - keine weitere Installation notwendig!
npx -y mempro-client
### Claude 桌面配置
**Mac/Linux** (`~/.claude.json`):```json
{
"mcpServers": {
"mempro": {
"command": "npx",
"args": ["-y", "mempro-client"]
}
}
}
视窗 (%APPDATA%\Claude\claude_desktop_config.json):```json
{
"mcpServers": {
"mempro": {
"command": "npx",
"args": ["-y", "mempro-client"]
}
}
}
### 重新启动 Claude
1. 完全关闭 Claude Desktop
1. 重新启动
1. ✅ MCP工具应该可用
## 🎯 可用工具
### `mempro_health()`
后端健康检查```javascript
{
"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"
**退货:**```json
{
"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?"
**退货:**```json
{
"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
**退货:**```json
{
"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```json
{
"mcpServers": {
"mempro": {
"command": "npx",
"args": ["-y", "mempro-client"],
"env": {
"MEMPRO_URL": "https://custom-mempro.example.com"
}
}
}
}
多用户设置```json
{
"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
1. 检查配置文件(JSON有效吗?)
1. 打开终端: `npx -y mempro-client` (应该等待,而不是崩溃)
### 连接被拒绝```bash
# Test vom PC:
curl http://135.181.128.98:8821/healthz
# Sollte: {"status":"ok","backends":{...}}
如果没有:
- 检查防火墙规则
- 检查 VPN/网络配置
- 后端运行? (查看Hetzner)
NPX LäDT尤因```bash
Alternative: Globale Installation
npm install -g mempro-client
Dann in Config:
"command": "mempro-client"
## 📝 发展```bash
# 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
由以下材料制成❤️ 用于集中式内存编排
