<div align="center">

# sync-vault-agent

**让你的 AI 直接读写百度网盘、阿里云盘、115、夸克、OneDrive**

[![npm version](https://img.shields.io/npm/v/sync-vault-agent?style=flat-square)](https://www.npmjs.com/package/sync-vault-agent?utm_source=github&utm_medium=readme)
[![npm downloads](https://img.shields.io/npm/dm/sync-vault-agent?style=flat-square)](https://www.npmjs.com/package/sync-vault-agent?utm_source=github&utm_medium=readme)
[![License](https://img.shields.io/npm/l/sync-vault-agent?style=flat-square)](LICENSE)
[![Dependencies](https://img.shields.io/badge/dependencies-0-brightgreen?style=flat-square)](https://www.npmjs.com/package/sync-vault-agent?utm_source=github&utm_medium=readme)
[![GitHub](https://img.shields.io/badge/github-abcamus/sync--vault--agent-181717?style=flat-square&logo=github)](https://github.com/abcamus/sync-vault-agent)

</div>

> **⚠️ Want to see it in action?** Add your screenshot at `docs/hero.png` — or [try it now](https://mcp.sync-vault.com?utm_source=github&utm_medium=readme) with a free account.

## What is this?

When your AI assistant (Claude Code, Cursor, Windsurf) needs to find a file on your cloud drive — a quarterly report on Baidu, a meeting note on OneDrive — you want it to just **find it**. Not switch between 5 browser tabs, not download and re-upload.

`sync-vault-agent` is the missing link. An [MCP](https://modelcontextprotocol.io) server that connects AI clients to your cloud storage accounts. One `npm install`, one config, and your AI can search, read, and manage files across 5 cloud drives as if they were local.

English · [中文](README_zh.md)

## Demo

> *"Find the Q4 report in Baidu, search all drives for budget.xlsx, read yesterday's meeting notes from OneDrive"*

<!--
TODO: Add a screen recording GIF showing:
1. User asks AI to find a file
2. AI searches across connected drives
3. Returns results with file preview
-->

## Supported Drives

| Drive | Auth | Status |
|-------|------|--------|
| 百度网盘 (Baidu) | OAuth | ✅ |
| 阿里云盘 (Aliyun) | OAuth | ✅ |
| 115 网盘 | OAuth | ✅ |
| OneDrive | OAuth | ✅ |
| 夸克网盘 (Quark) | Cookie | ✅ |

## Quick Start

```bash
# 1. Install the agent globally
npm install -g sync-vault-agent

# 2. Initialize (creates config + opens browser for login)
mcp-agent init

# 3. Add to your AI client's mcp.json
```

Add to `claude_desktop_config.json`, `~/.cursor/mcp.json`, or VS Code Continue config:

```json
{
  "mcpServers": {
    "unidrive": {
      "command": "mcp-agent",
      "args": ["start"]
    }
  }
}
```

**That's it.** Restart your AI client and you can start asking questions about your cloud files.

## Why sync-vault-agent?

### The problem
- Your AI can only access files on your local machine
- Cloud drive files are fragmented across 5+ different ecosystems
- Switching between drive UIs kills productivity

### The solution
`sync-vault-agent` gives your AI a unified gateway to all your cloud storage:

- **Multi-cloud, one agent** — connect Baidu, Aliyun, 115, OneDrive, Quark through a single MCP server
- **10+ AI clients supported** — Claude Code, Cursor, Windsurf, VS Code Continue, any MCP-compatible tool
- **30-second setup** — install, init, done
- **Zero dependencies** — pure Node.js, no bloated SDKs
- **Secure by design** — refresh tokens encrypted server-side, access tokens rotated every 2 hours, agent holds short-lived credentials only
- **Usage dashboard** — real-time analytics, per-drive breakdown

## Configuration

Config lives at `~/.config/sync-vault/agent.json`. Override via env vars:

| Variable | Default | Description |
|----------|---------|-------------|
| `SYNC_VAULT_API_KEY` | — | API key from [Dashboard](https://mcp.sync-vault.com/dashboard?utm_source=github&utm_medium=readme) |
| `SYNC_VAULT_AUTH_URL` | `https://auth.sync-vault.com` | Auth service URL |
| `SYNC_VAULT_STORE_PATH` | `~/.config/sync-vault/` | Credential store path |

## Build from Source

```bash
git clone https://github.com/abcamus/sync-vault-agent.git
cd sync-vault-agent
npm install
npm run build
```

## Contributing

PRs welcome! Please open an issue first to discuss changes.

## Links

- [🌐 UniDrive Landing Page](https://mcp.sync-vault.com?utm_source=github&utm_medium=readme)
- [📊 Dashboard](https://mcp.sync-vault.com/dashboard?utm_source=github&utm_medium=readme)
- [📦 npm Package](https://www.npmjs.com/package/sync-vault-agent?utm_source=github&utm_medium=readme)
- [🐛 Report a Bug](https://github.com/abcamus/sync-vault-agent/issues)
- [📝 Changelog](CHANGELOG.md)

## License

MIT © [Camus Qiu](https://github.com/abcamus)