Velixar MCP服务器
](https://www.npmjs.com/package/velixar-mcp-server) 
第一个用于AI助手的认知记忆服务器。不是矢量数据库包装器，而是一个完整的推理层，为您的AI提供持久内存、知识图、身份意识、矛盾检测和每个会话的信念跟踪。
适用于任何 模型上下文协议 客户端：Claude Desktop、Kiro、Cursor、Windsurf、Continue.dev或自定义主机。
为什么存在
每个AI助手在每次对话中都从零开始。Velixar修复了这个问题，但不仅仅是存储和检索文本。MCP服务器使您的助手能够：
- 东方本身 在只有一个调用的工作区中--没有手动上下文组装
- 追踪信仰如何演变 随着时间的推移，当它们相互矛盾时，就会浮出水面
- 构建并遍历知识图 它发现的实体和关系
- 维护持久的身份模型 你是谁，你喜欢什么，以及你是如何工作的
- Distill会话 通过重复数据删除功能，自动将数据写入持久内存
- 进出口 用于备份或迁移的整个内存语料库
25个工具。5个实时资源。16个工作流提示。一 npm install.
快速开始
npm install -g velixar-mcp-server在获取API密钥 velixarai.com/settings/api-keys，然后添加到您的MCP客户端：
{
"mcpServers": {
"velixar": {
"command": "velixar-mcp-server",
"env": {
"VELIXAR_API_KEY": "vlx_your_key_here"
}
}
}
}重新启动您的助手。完成。
刀具表面
记忆
| 工具 | 它做什么 |
|---|---|
velixar_store | 使用标签、层和类型存储内存 |
velixar_search | 跨所有记忆的语义搜索 |
velixar_list | 使用分页和过滤进行浏览 |
velixar_update | 编辑现有内存上的内容或标签 |
velixar_delete | 删除内存 |
认知
| 工具 | 它做什么 |
|---|---|
velixar_context | 综合工作空间简报——一次电话指导 |
velixar_identity | 获取、存储或更新用户的个人资料、偏好和专业知识 |
velixar_contradictions | 以解决方案为指导，揭示相互矛盾的事实或信念 |
velixar_timeline | 一个话题或信仰如何随着时间的推移而演变 |
velixar_patterns | 历史上反复出现的问题/解决方案主题 |
velixar_inspect | 对具有完整来源链的特定内存进行深入检查 |
velixar_graph_traverse | 行走实体关系——“什么与X有关？” |
velixar_distill | 通过重复数据删除从会话内容中提取持久记忆 |
生命周期
| 工具 | 它做什么 |
|---|---|
velixar_session_save | 保存会话摘要以供以后调用 |
velixar_session_recall | 从上一个会话还原上下文 |
velixar_batch_store | 一次通话最多可储存20段回忆 |
velixar_batch_search | 最多可同时运行10个搜索查询 |
velixar_consolidate | 将相关记忆合并到一个持久记忆中 |
velixar_retag | 跨存储器批量更新标签 |
velixar_export | 将内存导出为JSON或Markdown，可选择使用图形数据 |
velixar_import | 从JSON、Markdown、Notion或黑曜石导出批量导入 |
系统
| 工具 | 它做什么 |
|---|---|
velixar_health | 后端连接、延迟、工作区状态 |
velixar_debug | 缓存状态、断路器、API计时 |
velixar_capabilities | 功能列表、工具清单、资源URI |
velixar_security | 获取或设置内容扫描模式 |
实时资源
资源会自动注入到助手的上下文中，无需调用工具。
| 资源 | 它提供了什么 |
|---|---|
velixar://system/constitution | 助手的行为规则和认知模式 |
velixar://identity/current | 您的持久用户配置文件 |
velixar://memories/recent | 最近的存储器（紧凑型） |
velixar://memories/relevant | 基于当前活动的上下文相关记忆 |
velixar://domains/{domain}/shadow_graph | 特定领域的知识图视图 |
工作流提示
16个内置提示，指导多步骤推理工作流程：
- 定向 --回忆先前的推理，构建项目上下文，分析实体，定位然后缩小范围
- 冲突 --解决矛盾，找出知识差距
- 连续性 --追踪信念演变、恢复会话、重建决策路径
- 生命周期 --提取会话，巩固主题记忆，重新标记最近的记忆
- 身份 --总结用户身份，检测偏好变化，调整响应风格
- 企业 --评估企业是否适合某个领域
工作区隔离
记忆仅限于工作空间。你的个人项目永远不会影响工作。
| 优先级 | 来源 | 方式 |
|---|---|---|
| 1 | VELIXAR_WORKSPACE_ID 有一种嫉妒，很明显。 | |
| 2 | .velixar.json 在项目根中 | { "workspace_id": "my-project" } |
| 3 | Git根目录名称 | 自动 |
主机兼容性
| 主持人 | 工具 | 资源 | 提示 |
|---|---|---|---|
| Kiro命令行界面 | ✅ | ✅ | ✅ |
| 克劳德桌面 | ✅ | ✅ | ✅ |
| 光标 | ✅ | ⚠️ | — |
| 风浪 | ✅ | ⚠️ | — |
| 继续开发 | ✅ | ✅ | ✅ |
当主机不支持资源或提示时，服务器会优雅地降级——所有工具仍然独立工作。
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
VELIXAR_API_KEY | 是 | 您的API密钥（以 vlx_) |
VELIXAR_WORKSPACE_ID | 否 | 显式工作区范围 |
VELIXAR_API_URL | 否 | 自定义API终结点 |
VELIXAR_USER_ID | 否 | 内存作用域的用户ID |
VELIXAR_DEBUG | 没有 | true 用于详细日志记录 |
VELIXAR_LOG_FORMAT | 没有 | json 用于结构化Datadog/CloudWatch日志记录 |
VELIXAR_HEALTH_PORT | 否 | HTTP健康检查终结点的端口 |
可靠性
- 指数回退自动重试（3次尝试）
- 断路器——持续故障后打开，自动恢复
- 缓存回退——在中断期间提供过时数据，而不是失败
- 与Datadog和CloudWatch兼容的结构化日志记录
SDK
直接从代码中使用Velixar：
CI/CD集成
- GitHub 操作: velixar内存同步 --提炼公关融入记忆
- GitHub 操作: velixar决策捕获 --将问题解决方案存储为决策
- 网络钩子:
POST /webhook/ci--通用CI事件摄取
许可证
麻省理工学院