Omnidrive Mcp

OmniDrive

安全、本地优先的网关，将您的个人文件连接到任意 AI Agent。

OmniDrive 是一款“即插即用”的桌面应用，可让您有选择地与 Claude Desktop、Cursor、ChatGPT 和 Gemini 等 AI Agent 共享本地文件夹。它基于 Model Context Protocol (MCP) 构建，为 AI 助手提供查看文档、电子表格和代码库所需的“眼睛”，同时让您始终拥有绝对控制权。

---

为什么选择 OmniDrive？

目前，大多数 AI Agent 都“看不到上下文”——除非您手动上传文件，否则它们不知道您的设备上有什么。现有解决方案要么是复杂的终端工具，要么是不安全的“全盘访问”脚本。

OmniDrive 通过以下方式解决这一问题：

• 零配置：简洁美观的界面取代了复杂的 JSON 编辑。只需拖放即可共享。
• 安全优先（零信任）：AI 的访问权限受到严格限制，只能访问获准的路径。路径遍历（../）是不可能的。
• 细粒度权限：可随时将文件夹设为只读（安全浏览）或读写（自主编辑）。
• 实时活动流：实时查看 AI 执行的每次文件读取、搜索和编辑。

---

主要功能

• 通用兼容性：适用于任何支持 MCP 标准的大模型客户端。
• 即插即用：几秒钟即可添加文件夹。无需终端命令，也无需环境变量。
• 完全透明：专用的实时活动日志窗口会准确显示 AI 正在如何处理您的文件。
• 隐私保护设计：不会将任何文件上传到 OmniDrive 服务。一切操作都通过本地进程管道或安全的本地 SSE 桥接完成。
• 智能过滤：遵循 .mcpignore 文件，避免 node_modules 等内容出现在 AI 的视野中。

---

使用场景（不止于编码）

OmniDrive 是开发者的必备工具，也为所有人而设计：

研究与分析

共享本地 PDF 文档和研究笔记库。让 AI 综合数十份文档中的趋势，无需点击“上传”。

行政自动化

让 AI 访问您的电子表格和发票。请它生成摘要、识别异常或准备月度报告。

个人知识库

将您的 Obsidian 或 Markdown 笔记连接到 AI Agent。与您的“第二大脑”对话，实时发现想法之间的联系。

高级软件工程

赋予 AI 完整的读写权限，让它主动修复错误、重构架构，并验证整个代码库中的更改。

---

安全架构

OmniDrive 秉持“隐私优先”的理念构建：

• 规范路径验证：每个请求都会根据安全的白名单进行验证，白名单中仅包含用户批准的绝对路径。
• 沙箱隔离：即使大模型出现“幻觉”或具有恶意，也无法访问您明确共享的文件夹之外的内容。
• 配对 Web 连接：SSE（适用于浏览器 Agent）仅允许通过 127.0.0.1 连接，并要求安全握手，以防止未经授权的 Web 访问。

---

下载（最终用户）

如果您只想使用 OmniDrive，请从以下位置下载最新安装程序：

• GitHub Releases

可用安装包因平台而异，包括 .dmg（macOS）、.msi/.exe（Windows）以及 Linux 安装包。

修复 macOS 上的“已损坏，无法打开”提示

如果 macOS 在您从 Releases 下载 OmniDrive 后阻止其运行，请执行：

xattr -dr com.apple.quarantine /Applications/OmniDrive.app
xattr -dr com.apple.provenance /Applications/OmniDrive.app
open /Applications/OmniDrive.app

如有需要，右键点击 OmniDrive.app 并选择一次打开。

---

从源代码构建（开发者）

先决条件

• Node.js 20+
• Rust（stable）
• 您的操作系统所需的 Tauri 系统依赖项：Tauri Prerequisites

设置

1. 克隆仓库：

   git clone https://github.com/sp-22/omnidrive-mcp.git
   cd omnidrive-mcp
   

2. 安装依赖：

   npm ci
   

3. 在开发模式下运行：

   npm run tauri dev
   

4. 构建生产环境包：

   npm run tauri build
   

构建产物生成于 src-tauri/target/release/bundle/。

---

贡献

1. 复刻此仓库
2. 创建分支
3. 提交并推送更改
4. 发起 Pull Request

如需在不使用 Git 的情况下下载源代码，请在仓库页面使用 GitHub 的 Code -> Download ZIP。

---

发布流程（维护者）

此仓库包含一个 GitHub Actions 工作流，可在推送版本标签时为 macOS、Windows 和 Linux 构建并发布发行版资源。

1. 更新版本：

   • package.json
   • src-tauri/Cargo.toml
   • src-tauri/tauri.conf.json

2. 提交并推送：

   git add .
   git commit -m "chore: release v0.x.x"
   git push
   

3. 创建并推送标签：

   git tag v0.x.x
   git push origin v0.x.x
   

4. 工作流会将二进制文件发布到：

   • 发行版

---

技术栈

• 前端：React、TypeScript、原生 CSS（高级玻璃拟态）
• 引擎：Rust（高性能原生辅助进程）
• 框架：Tauri（安全的系统桥接）
• 协议：RMCP（Model Context Protocol 的 Rust 实现）

---

许可证

OmniDrive 依据 MIT License 发布。详情请参阅 LICENSE。