内容
<!--
连接器仓库，用于目录列表（mcp.so, Glama, PulseMCP, Smithery, awesome-mcp-servers）。
该仓库仅包含文档 - 它不包含服务器源代码。MCP 服务器包含在 1AIVault 桌面应用程序中。
如果您的 GitHub 组织/名称不同，请在整个仓库中替换 `stoicsoft/1AIVault-MCP-Server`。
-->
<p align="center">
<img src="assets/logo.png" alt="1AIVault" width="88">
</p>
<h1 align="center">1AIVault — MCP 服务器</h1>
<p align="center"><strong>您的便携式 AI 记忆库 — 记忆、技能和配置，在所有 AI 工具中共享。</strong></p>
<p align="center">
<img src="https://img.shields.io/badge/version-1.3.2-2563eb" alt="版本">
<img src="https://img.shields.io/badge/MCP-compatible-6E56CF" alt="MCP">
<img src="https://img.shields.io/badge/transport-stdio-16a34a" alt="传输">
<img src="https://img.shields.io/badge/tools-20-0891b2" alt="工具">
<img src="https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-64748b" alt="平台">
<img src="https://img.shields.io/badge/license-Commercial-f59e0b" alt="许可证">
</p>
1AIVault 是一个本地优先的桌面应用程序，作为 **便携式 AI 记忆库**。它将您的记忆、决定、偏好和可重复使用的技能存储在本地 SQLite 数据库中，并通过此 **模型上下文协议（MCP）** 服务器将它们暴露给您的 AI 客户端 - 因此，您告诉 Claude Desktop 的内容在 Cursor、Claude Code、Cline 等中是可用的。无需云，无需帐户，无需数据离开您的机器。
> **网站和下载：** **https://1aivault.com**
<p align="center">
<img src="assets/screenshot.jpg" alt="1AIVault 仪表盘" width="820">
</p>
---
## 为什么
每个 AI 工具都有自己的记忆孤岛。在一个工具中建立的上下文在另一个工具中是不可见的。1AIVault 为您提供 **一个记忆库**，所有 AI 客户端都通过单个 MCP 服务器读写 - 一个共享的、便携的脑，您拥有并存储在自己的磁盘上。
- 🧠 **跨工具记忆** - 在 Claude Desktop 中保存，在 Cursor 中回忆
- 🔒 **本地优先** - 一个位于 `~/.1aivault/vault.db` 的 SQLite 数据库，WAL 模式，永不上传
- 🕸️ **知识图谱** - 连接条目，遍历相关上下文，跨源自动提取主题
- 🧩 **可重复使用的技能** - 保存 AI 指令一次，在任何地方按名称加载
- ⚡ **零配置安装** - 应用程序为每个客户端一键写入 MCP 配置
<p align="center">
<img src="assets/graph.jpg" alt="1AIVault 中的跨源主题图谱" width="820">
</p>
---
## 安装
1AIVault 是一个桌面应用程序，它 **捆绑** 了这个 MCP 服务器 - 无需 `npx` 或克隆。
1. 从 **https://1aivault.com** （macOS · Windows · Linux）为您的操作系统 **下载** 应用程序
2. **打开** 1AIVault
3. 进入 **连接** 并点击您的人工智能客户端旁边的 **安装** - 1AIVault 自动写入 MCP 配置
### 支持的 AI 客户端
| 客户端 | 自动安装 |
|---|:---:|
| Claude Desktop | ✅ |
| Claude Code | ✅ |
| Cursor | ✅ |
| Cline (VS Code) | ✅ |
| Codex CLI | ✅ |
| Gemini CLI | ✅ |
| OpenCode | ✅ |
| Antigravity CLI | ✅ |
| ChatGPT Desktop | ✅ |
任何支持 **stdio** 服务器的 MCP 兼容客户端也可以手动指向它（参见 [工作原理](#工作原理)）。
---
## 工具
服务器通过 stdio 公开 **20 种工具**。您的 AI 客户端在您工作时自动调用它们。
| 工具 | 功能 |
|---|---|
| `vault_save` | 将记忆、决定、偏好或事实保存到持久存储库中 |
| `vault_search` | 对存储库进行全文搜索 - 支持 `"quoted phrases"`、`-exclude`、`tag:`、`tier:`、`category:` |
| `vault_recent` | 按时间顺序列出最近保存的条目 |
| `vault_by_tag` | 按标签获取条目 |
| `vault_update` | 编辑或重命名现有条目 |
| `vault_tags` | 列出所有标签及其计数 |
| `vault_get` | 按 ID 获取一个条目（完整内容） |
| `vault_save_conversation` | 将当前对话存档为摘要 + 全文 |
| `vault_load_skill` | 按名称加载用户定义的技能（可重复使用的 AI 指令） |
| `vault_list_skills` | 列出已保存的技能（名称 + 描述） |
| `vault_link` | 使用命名关系链接两个条目（知识图谱边） |
| `vault_related` | 从一个条目（最多 3 步）遍历知识图谱 |
| `vault_brain_query` | 关键字搜索 **+** 图谱遍历，以显示更丰富的连接上下文 |
| `vault_extract_insights` | 对条目运行自动链接/模式提取 |
| `vault_classify_pending` | 获取尚未分类为主题的条目 |
| `vault_save_classifications` | 将条目分配给跨源主题（并更新摘要） |
| `vault_list_topics` | 列出跨源主题及其条目计数和摘要预览 |
| `vault_topic_digest` | 获取主题的跨源摘要、别名和条目 |
| `vault_search_topics` | 对主题进行全文搜索 |
| `vault_link_topics` | 在主题之间声明类型化关系 |
---
## 工作原理
三个进程共享 **一个** SQLite 数据库（`~/.1aivault/vault.db`，WAL 模式）- 没有 HTTP 桥，WAL 处理跨进程并发：
```
Main (Electron) ─┐ ┌─ MCP 服务器子进程
├── ~/.1aivault/vault.db (WAL) ──┤ （由 Claude Desktop、
Renderer (UI) ───┘ └─ Cursor、Claude Code、Cline、… 启动）
```
每个 AI 客户端都启动自己的 MCP 服务器副本作为 stdio 子进程。在打包安装中，服务器通过应用程序自己的运行时运行（因此它共享与应用程序一起提供的确切本机模块 ABI），1AIVault 为您写入这样的配置 - 您不需要手动编辑它：
<details>
<summary>示例生成的配置（macOS）</summary>
```json
{
"mcpServers": {
"1aivault": {
"command": "/Applications/1AIVault.app/Contents/MacOS/1AIVault",
"args": [
".../app.asar.unpacked/dist/main/main/mcp/server.js",
"--source", "claude_desktop",
"--db", "/Users/you/.1aivault/vault.db"
],
"env": {
"ELECTRON_RUN_AS_NODE": "1",
"NODE_PATH": ".../app.asar.unpacked/node_modules"
}
}
}
}
```
路径由应用程序按每台机器解析。`--source` 标签记录了写入条目的客户端；`--db` 指向您的存储库。
</details>
---
## 隐私
- **100% 本地。** 您的存储库是磁盘上的一个文件。MCP 层不会向任何服务器发送任何内容。
- **您拥有数据。** 从桌面应用程序管理和导出数据，并在不同机器之间移动。
- **无需帐户** 即可使用存储库或 MCP 服务器。
---
## 链接
- 🌐 网站和下载 - https://1aivault.com
- 🏢 由 [StoicSoft](https://stoicsoft.com) 制作
- 📨 支持 - hello@stoicsoft.com
---
<sub>1AIVault 是商业软件。此仓库是捆绑的 MCP 服务器的文档；应用程序源代码不开源。 © StoicSoft。</sub>
