aliasunder/vault-cortex

镜像概述

Vault Cortex是一款独立的MCP服务器，专为Obsidian vault设计，无需插件或运行Obsidian客户端即可让AI代理访问和管理vault内容。它集成混合搜索、任务管理、结构化记忆等功能，并通过OAuth 2.1保障安全，支持本地运行或远程部署（如Render/Railway一键部署）。

核心功能

• 混合搜索: 结合FTS5关键词匹配与向量语义相似性，支持标签、文件夹、属性、日期等多维度过滤，提升搜索精准度。
• 任务管理: 兼容Obsidian Tasks插件和Dataview格式，支持任务查询、创建、更新（状态、优先级、日期等）操作。
• 结构化记忆: 基于日期的追加式记忆条目，支持主题召回（含历史演变）、记忆文件管理等功能。
• 文件处理: 支持图片（自动压缩）、PDF（文本提取/渲染）、Canvas（大纲转换）、数据文件（JSON/CSV等）的读取与展示。
• Obsidian原生支持: 理解frontmatter、wikilinks、标签、标题和每日笔记格式。
• 安全认证: 通过MCP令牌和OAuth 2.1保障远程访问安全。

使用场景

• 远程访问: 部署在云服务器上，通过Obsidian Sync同步vault，实现手机、AI客户端（如Claude）的跨设备访问。
• 本地协作: 绑定本地vault路径，让AI代理辅助知识整理、任务跟踪。
• AI集成: 对接Claude、OpenAI等AI模型，实现智能笔记分析、内容生成与更新。

配置说明

主要通过环境变量配置，关键变量如下：

部署示例

本地Docker运行

bash
docker run -d \
  --name vault-cortex \
  -p 3000:3000 \
  -v /your/local/vault/path:/vault \
  -e MCP_AUTH_TOKEN="your-secret-token" \
  -e VAULT_PATH="/vault" \
  -e TZ="Asia/Shanghai" \
  docker.xuanyuan.run/aliasunder/vault-cortex

Docker Compose示例

yaml
version: '3.8'
services:
  vault-cortex:
    image: aliasunder/vault-cortex
    ports:
      - "3000:3000"
    volumes:
      - /your/local/vault:/vault
    environment:
      - MCP_AUTH_TOKEN=your-secure-token
      - VAULT_PATH=/vault
      - TZ=Asia/Shanghai
      - READONLY_MODE=false