🧠 个人存储网关（PMG）
AI的隐私第一存储层。\ 通过安全、兼容MCP的网关，将您的本地知识与任何AI助手无缝连接。
](https://www.npmjs.com/package/@shubham-01-star/pmg)  
______________________________________________________________________
🚀 快速开始
在零配置的情况下，几秒钟内即可启动并运行：
npx @shubham-01-star/pmg init______________________________________________________________________
✨ 概述
个人记忆网关（PMG）是一个本地第一后端，旨在存储、管理您的个人知识，并将其提供给人工智能模型。它充当一个安全的“内存VPN”，确保在共享任何上下文之前，敏感数据被编辑，隐私被屏蔽。
🛠️ 核心能力
- MCP工具集成：通过以下方式无缝连接到Cursor、Claude Desktop和其他MCP客户端
query_personal_memory和save_memory工具。 - 隐私优先摄入：自动监视本地目录、分块文档并将其存储在本地向量数据库（LanceDB）中。
- 智能红行动：在检索之前，应用多阶段管道来编辑PII和敏感信息。
- Archestra集成：可选择通过Archestra（支持Gemini/OpenAI）等高性能网关路由响应。
- 遥测仪表板：通过内置的web界面监控系统运行状况并管理索引数据。
______________________________________________________________________
🏗️ 建筑
graph TD
A[Local Files] -->|Ingestion| B(Chunking & Embedding)
B -->|LanceDB| C[Vector Repository]
D[MCP Client] -->|Query| E[Privacy Pipeline]
E -->|Redaction| F[Consent Gate]
F -->|Context| G[AI Model]
C -->|Retrieval| E______________________________________________________________________
📦 安装
全局安装（推荐）
npm i -g @shubham-01-star/pmg
pmg init
pmg本地开发
git clone https://github.com/shubham-01-star/pmg.git
cd pmg
npm install
npm run build
npm run run______________________________________________________________________
🔌 MCP客户端配置
将PMG添加到您的 mcpServers 配置：
{
"mcpServers": {
"pmg": {
"command": "npx",
"args": ["-y", "@shubham-01-star/pmg"],
"env": {
"INGEST_DIR": "/path/to/your/data",
"LANCE_DB_PATH": "/path/to/lancedb/storage"
}
}
}
}______________________________________________________________________
⚙️ 环境变量
| 变量 | 描述 | 默认值 |
|---|---|---|
INGEST_DIR | 用于监视内存文件的目录 | my_data |
ARCHESTRA_ENABLE | 启用Archestra集成(0 或 1) | 0 |
EMBEDDING_PROVIDER | 嵌入模型源(local, gemini等等） | local |
DASHBOARD_PORT | 遥测仪表板端口 | 8787 |
PRIVACY_REDACT_PII | 启用PII编辑管道 | 1 |
______________________________________________________________________
📊 仪表盘
运行后，访问遥测仪表板： 👉 http://localhost:8787/dashboard
- 监视器：实时事件和内存检索统计数据。
- 管理：上传新文档或清除现有记忆。
- 状态：所有内部服务的视觉健康探测器。
______________________________________________________________________
🧪 测试与验证
PMG包括一套全面的烟雾测试和后端验证。
# Run backend smoke suite
make test-backend
# Integrated flow test
node scripts/one-command-flow.mjs "topic" "path/to/sample.txt"______________________________________________________________________
📜 许可证
根据MIT许可证分发。看 LICENSE 了解更多信息。
______________________________________________________________________
Built with ❤️ for the 2 Fast 2 MCP Hackathon