AI导哈

AI认知记忆服务器

Velixar MCP Server是一款为AI助手设计的认知记忆服务器，提供持久记忆、知识图谱、身份感知和矛盾检测等功能，适用于需要跨会话保持记忆的AI应用场景。

  • by VelixarAi
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 VelixarAi/velixar-mcp-server

使用说明

Velixar MCP服务器

第一个用于AI助手的认知记忆服务器。不是矢量数据库包装器，而是一个完整的推理层，为您的AI提供持久内存、知识图、身份意识、矛盾检测和每个会话的信念跟踪。

适用于任何 模型上下文协议 客户端：Claude Desktop、Kiro、Cursor、Windsurf、Continue.dev或自定义主机。

为什么存在

每个AI助手在每次对话中都从零开始。Velixar修复了这个问题，但不仅仅是存储和检索文本。MCP服务器使您的助手能够：

  • 东方本身 在只有一个调用的工作区中--没有手动上下文组装
  • 追踪信仰如何演变 随着时间的推移，当它们相互矛盾时，就会浮出水面
  • 构建并遍历知识图 它发现的实体和关系
  • 维护持久的身份模型 你是谁，你喜欢什么，以及你是如何工作的
  • Distill会话 通过重复数据删除功能，自动将数据写入持久内存
  • 进出口 用于备份或迁移的整个内存语料库

40个工具。5个实时资源。19个工作流提示。一 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 否 明确的最终用户身份。保留未设置（推荐）：API从您的键派生范围-您可以看到自己的记忆，就像仪表板一样。仅当一个密钥服务于多个命名的最终用户时才设置它
VELIXAR_DEBUG 没有 true 用于详细日志记录
VELIXAR_LOG_FORMAT 没有 json 用于结构化Datadog/CloudWatch日志记录
VELIXAR_HEALTH_PORT 否 HTTP健康检查终结点的端口

可靠性

  • 指数回退自动重试（3次尝试）
  • 断路器——持续故障后打开，自动恢复
  • 缓存回退——在中断期间提供过时数据，而不是失败
  • 与Datadog和CloudWatch兼容的结构化日志记录

SDK

直接从代码中使用Velixar：

  • JavaScript/TypeScript: npm install velixar — 文档
  • python: pip install velixar — 文档

CI/CD集成

许可证

麻省理工学院

相关 MCP