Post-Cortex
Persistent Memory for AI Assistants
Post Cortex是一个MCP服务器,为AI助手提供长期记忆。它通过自动实体提取将对话、决策和见解存储在可搜索的知识库中。
特性
- 持久内存 -会话在会话中持续存在
- 语义搜索 -使用带有HNSW索引的AI嵌入查找相关内容
- 图表RAG -搜索结果富含实体图洞察和关系路径
- 知识图谱 -自动实体和关系提取
- 隐私第一 -所有处理都在本地运行,没有外部API
- 快 -无锁Rust架构,O(log n)向量搜索,\<10ms查询
- 灵活的存储 -RocksDB(嵌入式)或SurrealDB(分布式)
安装
# Homebrew (macOS/Linux)
brew install julymetodiev/tap/post-cortex
# Or download binary
curl -L https://github.com/julymetodiev/post-cortex/releases/latest/download/pcx-aarch64-apple-darwin -o /usr/local/bin/pcx
chmod +x /usr/local/bin/pcx快速开始
1.配置MCP(一次,全局)
# HTTP transport (recommended, requires daemon running)
claude mcp add --scope user --transport http post-cortex http://127.0.0.1:3737/mcp
# Or stdio transport (no daemon needed)
claude mcp add --scope user --transport stdio post-cortex -- pcx这将为您计算机上的所有项目注册Post Cortex。
2.设置您的项目
pcx setup这创建了一个会话、工作空间, CLAUDE.md 使用内存规则、执行钩子和安装代理定义。看 使用指南 了解详情。
3.开始编码
claude克劳德在回答之前会自动搜索过去的知识,并记录新的发现。
MCP工具
| 工具 | 目的 |
|---|---|
session | 创建和列出会话 |
update_conversation_context | 存储知识(质量保证、决策、问题、代码更改) |
semantic_search | 跨会话、工作区或全局查找相关内容 |
get_structured_summary | 获取会话概述(决策、见解、实体) |
query_conversation_context | 查询实体关系和关键字搜索 |
manage_workspace | 将会议组织到工作区 |
守护程序模式
对于共享同一内存的多个Claude实例:
pcx start # Start daemon
pcx status # Check status
pcx stop # Stop daemon为HTTP传输配置Claude:
{
"mcpServers": {
"post-cortex": {
"type": "http",
"url": "http://localhost:3737/mcp"
}
}
}看 守护进程模式文档 了解详情。
数据导出/导入
pcx export --output backup.json # Full export
pcx export --output backup.json.gz # Compressed
pcx import --input backup.json # Import存储后端
| RocksDB(默认) | SurrealDB | |
|---|---|---|
| 设置 | 零配置 | 需要服务器 |
| 分布 | 嵌入式 | 分布式 |
| 矢量搜索 | HNSW O(对数n) | HNSW 0(对数n |
在中配置 ~/.post-cortex/daemon.toml。参见 守护进程模式文档.
环境变量
| 变量 | 默认值 | 描述 |
|---|---|---|
PC_HOST | 127.0.0.1 | 绑定地址 |
PC_PORT | 3737 | 港口 |
PC_DATA_DIR | ~/.后皮质/数据 | 存储位置 |
PC_STORAGE_BACKEND | rocksdb | rocksdb 或 surrealdb |
发展
cargo build --release --features "embeddings,surrealdb-storage"
cargo test
cargo bench许可证
麻省理工学院
