能力标签

🔌 MCP 🤖 Agent 🔄 工作流 🐳 Docker 💻 CLI 🧬 Embedding 🧠 Claude

🔌

MCP工具

Vault-Cortex

基于 TypeScript · 让 AI 助手直接操作你的系统与工具

英文名：vault-cortex

⭐ 6 Stars 💻 TypeScript 📄 MIT 🏷 AI 8.0分

8.0AI 综合评分

mcpai-agentshybrid-searchtypescript

⬇ 下载源码 ZIP ⚙️ 配置说明 📺 TG 频道

✦ AI Skill Hub 推荐

AI Skill Hub 强烈推荐：Vault-Cortex 是一款优质的MCP工具。AI 综合评分 8.0 分，在同类工具中表现稳健。如果你正在寻找可靠的MCP工具解决方案，这是一个值得深入了解的选择。

📚 深度解析

Vault-Cortex 是一款基于 MCP（Model Context Protocol）标准协议的 AI 工具扩展。MCP 协议由 Anthropic 开发并开源，旨在建立 AI 模型与外部工具之间的标准化通信接口，目前已被 Claude Desktop、Claude Code、Cursor 等主流 AI 工具采纳。

通过安装 Vault-Cortex，你的 AI 助手将获得额外的工具调用能力，可以用自然语言直接操控该工具的功能，无需学习复杂的命令行语法。MCP 工具的核心价值在于"一次配置，永久增强"——配置完成后，每次与 AI 对话时都可以无缝调用这些工具。

在技术实现上，MCP 工具通过标准的 JSON-RPC 协议与 AI 客户端通信，工具的功能以"工具列表"的形式暴露给 AI 模型，AI 可以按需调用。Vault-Cortex 提供了结构化的工具调用接口，使 AI 模型能够精确地理解和使用每个功能点，显著降低 AI 在工具使用上的错误率。

与传统的 API 集成相比，MCP 工具的优势在于无需编写代码——用户只需在配置文件中添加几行 JSON，即可让 AI 获得全新能力。AI Skill Hub 将 Vault-Cortex 评为 AI 评分 8.0 分，属于同类工具中的优质选择。

📋 工具概览

Vault-Cortex 是一款遵循 MCP（Model Context Protocol）标准协议的 AI 工具扩展。通过 MCP 协议，它可以让 Claude、Cursor 等主流 AI 客户端直接访问和操作外部工具、数据源和服务，实现 AI 能力的无缝扩展。无论是文件操作、数据库查询还是 API 调用，都可以通过自然语言在 AI 对话中直接触发，极大提升生产效率。

GitHub Stars

⭐ 6

开发语言

TypeScript

支持平台

Windows / macOS / Linux

维护状态

轻量级项目，按需更新

开源协议

MIT

AI 综合评分

8.0 分

工具类型

MCP工具

Forks

—

📖 中文文档

以下内容由 AI Skill Hub 根据项目信息自动整理，如需查看完整原始文档请访问底部「原始来源」。

📌 核心特色

通过标准 MCP 协议与 Claude、Cursor 等主流 AI 客户端深度集成
提供结构化工具调用接口，显著降低 AI 集成复杂度
支持 Claude Desktop 和 Claude Code 无缝接入，开箱即用
可与其他 MCP 工具组合叠加，构建完整 AI 工作站
轻量无侵入设计，不影响现有系统架构

🎯 主要使用场景

在 Claude Desktop 对话中直接调用本地工具，实现 AI 与系统的深度联动
通过自然语言驱动复杂的多步骤自动化任务，代替繁琐手动操作
将多个 MCP 工具组合使用，构建个人专属 AI 工作站

以下安装命令基于项目开发语言和类型自动生成，实际以官方 README 为准。

安装命令

# 方式一：通过 Claude Code CLI 一键安装
claude skill install https://github.com/aliasunder/vault-cortex

# 方式二：手动配置 claude_desktop_config.json
{
  "mcpServers": {
    "vault-cortex": {
      "command": "npx",
      "args": ["-y", "vault-cortex"]
    }
  }
}

# 配置文件位置
# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
# Windows: %APPDATA%/Claude/claude_desktop_config.json

📋 安装步骤说明

确认已安装 Node.js（v18 或以上版本）
打开 Claude Desktop 或 Claude Code 的 MCP 配置文件
按「交给 Agent 安装 → Claude Desktop」标签中的 JSON 配置填入 mcpServers 字段
保存配置文件并重启 Claude 客户端
重启后，在对话中即可使用本工具

以下用法示例由 AI Skill Hub 整理，涵盖最常见的使用场景。

常用命令 / 代码示例

# 安装后在 Claude 对话中直接使用
# 示例：
用户: 请帮我用 Vault-Cortex 执行以下任务...
Claude: [自动调用 Vault-Cortex MCP 工具处理请求]

# 查看可用工具列表
# 在 Claude 中输入："列出所有可用的 MCP 工具"

以下配置示例基于典型使用场景生成，具体参数请参照官方文档调整。

配置示例

// claude_desktop_config.json 配置示例
{
  "mcpServers": {
    "vault-cortex": {
      "command": "npx",
      "args": ["-y", "vault-cortex"],
      "env": {
        // "API_KEY": "your-api-key-here"
      }
    }
  }
}

// 保存后重启 Claude Desktop 生效

📑 README 深度解析真实文档完整度 44/100 含工作流图查看 GitHub 原文 →

以下内容由系统直接从 GitHub README 解析整理，保留代码块、表格与列表结构。

简介

</div>

Vault Cortex is a standalone MCP server that gives any AI agent hybrid search, task queries, structured memory, and read/write access to your Obsidian vault. No plugins, no running Obsidian, no separate bridge. One Docker container, your vault folder, 26 tools + 3 guided prompts. Deploy on a VPS with Obsidian Sync and the same vault is accessible from your phone, claude.ai, or any remote MCP client, secured with OAuth 2.1.

Contents — What you get · Quick Start · How It Works · Hybrid Search · Tools · Prompts · Config · Auth · Deployment

Local (2 minutes — Docker + your vault folder)

Prerequisites: Docker, Node.js >= 20.12 (only for the CLI — the server itself runs in Docker), and an Obsidian vault (or any folder of .md files).

npx vault-cortex@latest init

That's it — the CLI asks for your vault path, generates the auth token and config files, starts the server, and prints the connection details for your MCP client.

<details> <summary><strong>Manual setup</strong> (no Node.js needed)</summary>

```bash

Remote (access from anywhere — Docker + Obsidian Sync)

Prerequisites: a VPS with Docker, an Obsidian Sync subscription, and Node.js >= 20.12 (only for the CLI — the server itself runs in Docker).

```bash

Deployment Options

Path	What	Guide
Local	Docker on your machine, vault bind-mounted	[`deploy/local/`](./deploy/local/)
Remote	VPS + Obsidian Sync, access from anywhere	[`deploy/remote/`](./deploy/remote/)
AWS (SST)	Full IaC: Lightsail + API Gateway + Lambda + CI/CD	[`DEPLOY.md`](./DEPLOY.md)

Quick Start

1. Get the quickstart files

curl -O https://raw.githubusercontent.com/aliasunder/vault-cortex/main/deploy/local/docker-compose.yml curl -O https://raw.githubusercontent.com/aliasunder/vault-cortex/main/deploy/local/.env.example

2. Configure

cp .env.example .env

Edit .env — set MCP_AUTH_TOKEN (openssl rand -hex 32) and VAULT_PATH

Edit .env — set MCP_AUTH_TOKEN, PUBLIC_URL, OBSIDIAN_AUTH_TOKEN, VAULT_NAME

docker compose up -d ```

</details>

Full remote guide →

Configuration

All settings are environment variables with sensible defaults.

Variable	Required?	Default	Description
`MCP_AUTH_TOKEN`	Yes	—	Bearer token for authentication (also the JWT signing key)
`VAULT_PATH`	Local only	—	Host path to your vault (bind mount source; remote uses a named volume)
`PUBLIC_URL`	Remote only	—	Public URL for OAuth discovery metadata
`EMBEDDING_ENABLED`	—	`true`	Set `false` to disable the embedding pipeline — skips model download, vector tables, embedding passes, and hybrid search. Search falls back to FTS5 keyword matching.
`RERANK_MODE`	—	`blended`	Cross-encoder reranking mode: `blended` applies position-aware score blending after RRF fusion (~200ms added latency), `none` skips reranking. Only takes effect when `EMBEDDING_ENABLED` is true.
`MEMORY_ENABLED`	—	`true`	Set `false` to fully disable the memory layer — hides memory tools, skips bootstrap, omits memory from server metadata. `MEMORY_DIR` is ignored when `false`.
`MEMORY_DIR`	—	`About Me`	Vault folder for structured memory files
`PROTECTED_PATHS`	—	`MEMORY_DIR, Daily Notes`	Folders that `vault_delete_note` refuses to touch
`ORPHAN_EXCLUDE_FOLDERS`	—	`Daily Notes, Templates, MEMORY_DIR`	Folders excluded from orphan detection
`TZ`	—	`UTC`	IANA timezone for timestamps and daily note resolution
`SERVICE_DOCUMENTATION_URL`	—	GitHub repo URL	URL returned in OAuth discovery metadata
`LOG_LEVEL`	—	`info`	Logging verbosity: `debug`, `info`, `warn`, `error`
`LOG_DIR`	—	`/data/logs` (Docker)	Directory for persistent log files. Logs survive container restarts.
`LOG_RETENTION_DAYS`	—	`30`	Days to keep log files before automatic cleanup on startup
`WINDOWS_MODE`	—	`false`	On Windows? Set `true`. Switches the file watcher to polling and note moves to rename-based writes so a vault on a `C:` drive works through Docker Desktop. Safe to leave on for any Windows setup; unneeded on macOS/Linux/WSL2.

Smart defaults: Setting MEMORY_DIR automatically updates the defaults for PROTECTED_PATHS and ORPHAN_EXCLUDE_FOLDERS. You only set those explicitly for a fully custom list. When MEMORY_ENABLED is false, the memory layer is fully disabled — memory tools are hidden and the memory folder is not auto-created.

See templates/memory/ for memory file examples and the dated-entry design philosophy.

🎯 aiskill88 AI 点评 A 级 2026-07-05

功能强大，支持混合搜索和结构化记忆

📚 实用指南（长尾问题）

适合谁